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: 12 days 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 (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-04-29T12:44:06.000Z (about 2 months ago)
• Last Synced: 2024-05-02T02:15:28.789Z (about 2 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

Lists

• awesome-beancount - ING

README

        
# Beancount ING Importer

[![image](https://github.com/siddhantgoel/beancount-ing/workflows/beancount-ing/badge.svg)](https://github.com/siddhantgoel/beancount-ing/workflows/beancount-ing/badge.svg)

[![image](https://img.shields.io/pypi/v/beancount-ing.svg)](https://pypi.python.org/pypi/beancount-ing)

[![image](https://img.shields.io/pypi/pyversions/beancount-ing.svg)](https://pypi.python.org/pypi/beancount-ing)

[![image](https://img.shields.io/badge/code%20style-black-000000.svg)](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.

## Usage

If you're not familiar with how to import external data into Beancount, please

read [this guide] first.

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',

        'Max 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/

[config file]: https://beancount.github.io/docs/importing_external_data.html#configuration

[ING]: https://www.ing.de/

[Poetry]: https://python-poetry.org/

[this guide]: https://beancount.github.io/docs/importing_external_data.html