| Name | bankr JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | None |
| Summary | Simple Python code for your Bank Accounting |
| upload_time | 2025-01-11 08:52:34 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | None |
| keywords |
account
accounting
bank
banking
pandas
panel
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Bankr
[](https://pypi.org/project/bankr)
[](https://pypi.org/project/bankr)
-----
*Bankr is simple Python for your Bank Accounting to categorize your incomes and expenses*
## About
*Bankr*…
- …collects all your bank transactions on your chart of accounts using a CLI. The collection of the transactions is performed via CSV export from your bank accounts.
- …categorizes the transactions using a simple filter mechanism for repeating bookings. One-time transactions can be categorized by hand.
- …allows to add, edit and delete bank transactions by hand.
- …and finally, shows plots and statistics on the Book within the CLI or your web browser.
- …is configured via small and human-readable YAML files, which you can modify using any editor.
- …and, hopefully, creates an overview over your finances.
---
***Alpha** Software*
This software is in **Alpha** state. There are a several TODOs in the source code, and some further limitations to remove for completion of its functionality! However, `v1` of the data format should be stable right now.
---
## Motivation
My motivation for writing these lines of Python code are two-fold:
1. Learning *Python*, *Pandas*, and - currently at very basic level in this Python project - *Panel*.
2. Starting with CSV based accounting, especially after some negative experiences with trying to use an [HBCI (now FinTS)](https://en.wikipedia.org/wiki/FinTS) based accounting system. At least in Germany, banks tend to break their own HBCI accesses, especially since their most important accesses seem to be their own and individual banking apps. Fortunately, I am not aware of a bank, which does not allow a CSV based download of the respective transaction data.
## Installation
Install `python` and `pip` for your system, and do the following installation into a virtual environment `bankr`:
```console
python -m venv bankr
cd bankr
pip install bankr
```
*Bankr* includes fictional sample data in `bankr/data.sample` and a sample config file `bankr/bankr.sample.yaml`. Linking to the folder and the config file from your working directory, having the virtual environment activated, should allow to run Bankr on this sample data:
```console
ln -s <path/to/bankr/bankr.sample.yaml> bankr.yaml
ln -s <path/to/bankr/data.sample> data
```
Check the consistency of your configuration, and give it a try: `bankr stats`. If you see a big *Bankr* headline and a table of four "fantastic" bank accounts, you are in.
---
**Note** *Bankr* is tested on Linux only right now. Give it a try on BSD, Windows or Mac. I would not expect any hickups, but be prepared. You are heartily invited to provide feedback.
---
## Documentation
*Bankr* is fully documented [here](https://rokor.codeberg.page/bankr).
## License
*Bankr* is distributed under the terms of the [Unlicense](https://spdx.org/licenses/Unlicense.html) license.
Raw data
{
"_id": null,
"home_page": null,
"name": "bankr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "account, accounting, bank, banking, pandas, panel",
"author": null,
"author_email": "Robert Kormann <rokor@kormann.info>",
"download_url": "https://files.pythonhosted.org/packages/d8/18/152fbb7f11bae9a64380f43f3314955e1c6b1c951191324e638b380d5989/bankr-0.0.2.tar.gz",
"platform": null,
"description": "# Bankr\n\n[](https://pypi.org/project/bankr)\n[](https://pypi.org/project/bankr)\n\n-----\n\n*Bankr is simple Python for your Bank Accounting to categorize your incomes and expenses*\n\n\n## About\n\n*Bankr*\u2026\n\n- \u2026collects all your bank transactions on your chart of accounts using a CLI. The collection of the transactions is performed via CSV export from your bank accounts.\n- \u2026categorizes the transactions using a simple filter mechanism for repeating bookings. One-time transactions can be categorized by hand.\n- \u2026allows to add, edit and delete bank transactions by hand.\n- \u2026and finally, shows plots and statistics on the Book within the CLI or your web browser.\n- \u2026is configured via small and human-readable YAML files, which you can modify using any editor.\n- \u2026and, hopefully, creates an overview over your finances.\n\n---\n\n***Alpha** Software*\n\nThis software is in **Alpha** state. There are a several TODOs in the source code, and some further limitations to remove for completion of its functionality! However, `v1` of the data format should be stable right now.\n\n---\n\n\n## Motivation\n\nMy motivation for writing these lines of Python code are two-fold:\n\n1. Learning *Python*, *Pandas*, and - currently at very basic level in this Python project - *Panel*.\n2. Starting with CSV based accounting, especially after some negative experiences with trying to use an [HBCI (now FinTS)](https://en.wikipedia.org/wiki/FinTS) based accounting system. At least in Germany, banks tend to break their own HBCI accesses, especially since their most important accesses seem to be their own and individual banking apps. Fortunately, I am not aware of a bank, which does not allow a CSV based download of the respective transaction data.\n\n\n## Installation\n\nInstall `python` and `pip` for your system, and do the following installation into a virtual environment `bankr`:\n\n```console\npython -m venv bankr\ncd bankr\npip install bankr\n```\n\n*Bankr* includes fictional sample data in `bankr/data.sample` and a sample config file `bankr/bankr.sample.yaml`. Linking to the folder and the config file from your working directory, having the virtual environment activated, should allow to run Bankr on this sample data:\n\n```console\nln -s <path/to/bankr/bankr.sample.yaml> bankr.yaml\nln -s <path/to/bankr/data.sample> data\n```\n\nCheck the consistency of your configuration, and give it a try: `bankr stats`. If you see a big *Bankr* headline and a table of four \"fantastic\" bank accounts, you are in.\n\n---\n\n**Note** *Bankr* is tested on Linux only right now. Give it a try on BSD, Windows or Mac. I would not expect any hickups, but be prepared. You are heartily invited to provide feedback.\n\n---\n\n\n## Documentation\n\n*Bankr* is fully documented [here](https://rokor.codeberg.page/bankr).\n\n\n## License\n\n*Bankr* is distributed under the terms of the [Unlicense](https://spdx.org/licenses/Unlicense.html) license.\n",
"bugtrack_url": null,
"license": null,
"summary": "Simple Python code for your Bank Accounting",
"version": "0.0.2",
"project_urls": {
"Documentation": "https://rokor.codeberg.page/bankr",
"Issues": "https://codeberg.org/rokor/bankr/issues",
"Source": "https://codeberg.org/rokor/bankr"
},
"split_keywords": [
"account",
" accounting",
" bank",
" banking",
" pandas",
" panel"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ae8ef50efef7362e270cb04be0c67a31205377c42eca76ecb05d823927291f39",
"md5": "2f0a58e21285dcaf2c48aef423dec430",
"sha256": "421d3005743a479d387469fb5e95e2de47e7823f487cd02847a3e5f0259c2c96"
},
"downloads": -1,
"filename": "bankr-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f0a58e21285dcaf2c48aef423dec430",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 29872,
"upload_time": "2025-01-11T08:52:31",
"upload_time_iso_8601": "2025-01-11T08:52:31.783962Z",
"url": "https://files.pythonhosted.org/packages/ae/8e/f50efef7362e270cb04be0c67a31205377c42eca76ecb05d823927291f39/bankr-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d818152fbb7f11bae9a64380f43f3314955e1c6b1c951191324e638b380d5989",
"md5": "b44ef16725a35aa3f92335f84fd41b20",
"sha256": "17cfde4ba933e941198d29d54df002ee9aa28d14f311d039758c357d41b9006a"
},
"downloads": -1,
"filename": "bankr-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "b44ef16725a35aa3f92335f84fd41b20",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 26973,
"upload_time": "2025-01-11T08:52:34",
"upload_time_iso_8601": "2025-01-11T08:52:34.326047Z",
"url": "https://files.pythonhosted.org/packages/d8/18/152fbb7f11bae9a64380f43f3314955e1c6b1c951191324e638b380d5989/bankr-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-11 08:52:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": true,
"codeberg_user": "rokor",
"codeberg_project": "bankr",
"lcname": "bankr"
}
