initial commit

.editorconfig

@@ -0,0 +1,21 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[{.,}*.{js{,*},y{a,}ml}]
+indent_style = space
+indent_size = 2
+
+[*.{md,txt}]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

.eslintrc

@@ -0,0 +1,5 @@
+{
+  "extends": [
+	"plugin:unicorn/all"
+  ]
+}

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [ephigenia]
+open_collective: ephigenia

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/auto_assign.yml

@@ -0,0 +1,27 @@
+# https://github.com/kentaro-m/auto-assign/
+# Set to true to add reviewers to pull requests
+addReviewers: true
+
+# Set to true to add assignees to pull requests
+addAssignees: false
+
+# A list of reviewers to be added to pull requests (GitHub user name)
+reviewers:
+  - Ephigenia
+
+# A number of reviewers added to the pull request
+# Set 0 to add all the reviewers (default: 0)
+numberOfReviewers: 0
+
+# A list of assignees, overrides reviewers if set
+# assignees:
+#   - assigneeA
+
+# A number of assignees to add to the pull request
+# Set to 0 to add all of the assignees.
+# Uses numberOfReviewers if unset.
+# numberOfAssignees: 2
+
+# A list of keywords to be skipped the process that add reviewers if pull requests include it
+# skipKeywords:
+#   - wip

.github/workflows/check-pr-title.yml

@@ -0,0 +1,22 @@
+name: Check PR title
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - edited
+      - synchronize
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: aslafy-z/[email protected]
+        with:
+          success-state: Title follows the specification.
+          failure-state: Title does not follow the specification.
+          context-name: conventional-pr-title
+          preset: conventional-changelog-angular@latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/default.yml

@@ -0,0 +1,38 @@
+name: default
+
+on: [push]
+
+jobs:
+  lint:
+    name: Lint Code Base
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        # Full git history is needed to get a proper list of changed files within `super-linter`
+        fetch-depth: 0
+    - uses: github/super-linter/slim@v4
+      env:
+        DEFAULT_BRANCH: master
+        GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+        VALIDATE_ALL_CODEBASE: true
+        VALIDATE_JAVASCRIPT_ES: true
+        VALIDATE_EDITORCONFIG: true
+        VALIDATE_YAML: true
+        VALIDATE_BASH: true
+        VALIDATE_BASH_EXEC: true
+        FILTER_REGEX_EXCLUDE: CHANGELOG.md
+
+  test:
+    name: test
+    runs-on: ubuntu-latest
+    needs: [lint]
+
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+      with:
+        node-version-file: '.nvmrc'
+        cache: 'npm'
+    - run: npm ci --no-production
+    - run: npm test

.gitignore

@@ -0,0 +1,10 @@
+# nodejs
+# ------
+# Dependency directory
+# Commenting this out is preferred by some people, see
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
+node_modules
+npm-debug.log
+
+local.*
+*.tmp*

.nvmrc

@@ -0,0 +1 @@
+16

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Ephigenia M. Eichner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,44 @@
+*Project is work in progress.*
+
+Command Line Interface ([CLI](https://en.wikipedia.org/wiki/Command-line_interface)) Tool for using the [Kontist](https://kontist.com/) API which under the hood relies on their marvelous [GraphQL API](https://kontist.dev/docs/#schema-reference) [Kontist Javascript SDK](https://kontist.dev/sdk/#using-the-sdk)
+
+# Ideas 
+
+- [x] get current balance (`kontist-cli balance`, returns availableBalance)
+- [ ] make transaction `kontist-cli` … in progress
+- [ ] make timed transaction https://kontist.dev/sdk/#create-a-timed-order
+- [x] money format?
+- [x] currency?
+- [ ] list transactions
+    - [ ] limit transactions
+    - [ ] paginate transactions
+    - [x] search transactions
+- [ ] get future transactions
+- [ ] categorize single transaction (https://kontist.dev/sdk/#categorize-a-transaction)
+- [ ] listen for new transactions (https://kontist.dev/sdk/#subscribe-to-new-transactions)
+
+# Setup
+
+- Valid client id for authentication. Request your client id in the API Client Management on https://kontist.dev/client-management/.
+    ```
+    kontist-cli login -c <oauth-client-id> -u <username> -p <password>
+    ```
+
+# Examples
+
+The command-line-tool does not include any table formater or filtering mechanism as there are other nice tools for that like [table-printer-cli](https://www.npmjs.com/package/table-printer-cli) for formatting JSON output to a nice-looking table and [jq](https://stedolan.github.io/jq/) for transforming and filtering JSON.
+
+Both tools in combination can be used to create a nice-looking, customizable list of transactions:
+
+    kontist-cli transactions | jq -c 'map({bookingDate, valutaData,amount,name,iban})' | npx table-printer-cli -s
+
+Some other command rely on the systems `LC_ALL`, `LC_TIME`, or `LC_NUMERIC` variables to format monetary values or provide additional formatted dates. The `balance` sub-command:
+
+    $ LC_ALL=de-de kontist-cli balance
+    50,20 €
+
+# Other Projects / Bookmarks
+
+- [Netnexus/IKontist](https://github.com/netnexus/IKontist)
+- [N26 CLI (Python)](https://github.com/femueller/python-n26)
+- [Teller CLI](https://github.com/sebinsua/teller-cli)