seands/beancount-dkb

Beancount Importers for DKB CSV Exports

Beancount DKB Importer

beancount-dkb provides an Importer for converting CSV exports of DKB (Deutsche Kredit Bank) account summaries to the Beancount format.

Installation

$ pip install beancount-dkb

In case you prefer installing from the Github repository, please note that master is the development branch so stable is what you should be installing from.

Usage

from beancount_dkb import ECImporter, CreditImporter

IBAN_NUMBER = 'DE99 9999 9999 9999 9999 99' # your real IBAN number

CARD_NUMBER = '9999 9999 9999 9999'         # your real Credit Card number

CONFIG = [
    ECImporter(
        IBAN_NUMBER,
        'Assets:DKB:EC',
        currency='EUR',
        file_encoding='utf-8',
    ),

    CreditImporter(
        CARD_NUMBER,
        'Assets:DKB:Credit',
        currency='EUR',
        file_encoding='utf-8',
    )
]

FAQ

ERROR:root:Importer beancount_dkb.ec.ECImporter.identify() raised an unexpected error: 'utf-8' codec can't decode byte 0xf6 in position 17: invalid start byte

Change the file_encoding parameter. It seems like the CSV exports are ISO-8859-1 encoded, but utf-8 seems like a useful default.

Contributing

Contributions are most welcome!

Please make sure you have Python 3.5+ and Poetry installed.

1. Git clone the repository - git clone https://github.com/siddhantgoel/beancount-dkb
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 py.test.