Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/siddhantgoel/beancount-ing
Beancount Importers for ING (Germany) CSV Exports
https://github.com/siddhantgoel/beancount-ing
accounting banking beancount beancount-importers finance germany ing personal-finance plaintext-accounting python3
Last synced: about 1 month ago
JSON representation
Beancount Importers for ING (Germany) CSV Exports
- Host: GitHub
- URL: https://github.com/siddhantgoel/beancount-ing
- Owner: siddhantgoel
- License: mit
- Created: 2018-07-25T11:59:52.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-04-29T12:44:06.000Z (8 months ago)
- Last Synced: 2024-05-02T02:15:28.789Z (7 months ago)
- Topics: accounting, banking, beancount, beancount-importers, finance, germany, ing, personal-finance, plaintext-accounting, python3
- Language: Python
- Homepage:
- Size: 695 KB
- Stars: 18
- Watchers: 3
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-beancount - ING
README
# Beancount ING Importer
[](https://github.com/siddhantgoel/beancount-ing/workflows/beancount-ing/badge.svg)
[](https://pypi.python.org/pypi/beancount-ing)
[](https://pypi.python.org/pypi/beancount-ing)
[](https://github.com/psf/black)
`beancount-ing` provides an Importer for converting CSV exports of
[ING] (Germany) account summaries to the [Beancount] format.
## Installation
```sh
$ pip install beancount-ing
```
In case you prefer installing from the Github repository, please note that
`main` is the development branch so `stable` is what you should be installing
from.
Note that v1.x will *only* work with Beancount 3.x, while v0.x will *only* work with
Beancount 2.x, due to incompatibilities between Beancount 3.x and 2.x.
## Usage
If you're not familiar with how to import external data into Beancount, please
read [this guide] first.
### Beancount 3.x
Beancount 3.x has replaced the `config.py` file based workflow in favor of having a
script based workflow, as per the [changes documented here]. As a result, the importer's
initialization parameters have been shifted to `pyproject.toml`.
Add the following to your `pyproject.toml` in your project root.
```toml
[tool.beancount-ing.ec]
iban = "DE99 9999 9999 9999 9999 99"
account_name = "Assets:ING:EC"
user = "Erika Mustermann"
file_encoding = "ISO-8859-1" # optional
```
Run `beancount-ing-ec` to call the EC importer. The `identify` and `extract` subcommands
would identify the file and extract transactions for you.
```sh
$ beancount-ing-ec extract transaction.csv >> you.beancount
```
### Beancount 2.x
Adjust your [config file] to include the provided `ECImporter`. A sample configuration
might look like the following:
```python
from beancount_ing import ECImporter
CONFIG = [
# ...
ECImporter(
IBAN_NUMBER,
"Assets:ING:EC",
"Erika Mustermann",
file_encoding="ISO-8859-1",
),
# ...
]
```
Once this is in place, you should be able to run `bean-extract` on the command
line to extract the transactions and pipe all of them into your Beancount file.
```sh
$ bean-extract /path/to/config.py transaction.csv >> you.beancount
```
## Contributing
Contributions are most welcome!
Please make sure you have Python 3.8+ and [Poetry] installed.
1. Clone the repository: `git clone https://github.com/siddhantgoel/beancount-ing`
2. Install the packages required for development: `poetry install`
3. That's basically it. You should now be able to run the test suite: `poetry
run pytest tests/`.
[Beancount]: http://furius.ca/beancount/
[ING]: https://www.ing.de/
[Poetry]: https://python-poetry.org/
[changes documented here]: https://docs.google.com/document/d/1O42HgYQBQEna6YpobTqszSgTGnbRX7RdjmzR2xumfjs/edit#heading=h.hjzt0c6v8pfs
[config file]: https://beancount.github.io/docs/importing_external_data.html#configuration
[this guide]: https://beancount.github.io/docs/importing_external_data.html