معرفی شرکت ها
beancount-dkb-0.9.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Beancount Importer for DKB CSV exports
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | beancount-dkb-0.9.0 |
| نام | beancount-dkb |
| نسخه کتابخانه | 0.9.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Siddhant Goel |
| ایمیل نویسنده | me@sgoel.dev |
| آدرس صفحه اصلی | https://github.com/siddhantgoel/beancount-dkb |
| آدرس اینترنتی | https://pypi.org/project/beancount-dkb/ |
| مجوز | MIT |
# Beancount DKB Importer
[](https://github.com/siddhantgoel/beancount-dkb/workflows/beancount-dkb/badge.svg)
[](https://pypi.python.org/pypi/beancount-dkb)
[](https://pypi.python.org/pypi/beancount-dkb)
[](https://github.com/psf/black)
`beancount-dkb` provides an Importer for converting CSV exports of [DKB]
(Deutsche Kreditbank) account summaries to the [Beancount] format.
## Installation
```sh
$ pip install beancount-dkb
```
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 `ECImporter` and `CreditImporter`
(depending on what account you're trying to import).
A sample configuration might look like the following:
```python
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',
)
]
```
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
```
### Transaction Codes as Meta Tags
By default, the ECImporter prepends the transaction code ("Buchungstext") to the
transaction description. To achieve shorter descriptions and use meta tags to
query for certain transaction codes, the importer may be configured to store the
transaction code in a user provided meta tag.
The following configuration instructs the importer to use a meta tag `code` to
store transaction codes:
```python
...
CONFIG = [
ECImporter(
IBAN_NUMBER,
'Assets:DKB:EC',
currency='EUR',
meta_code='code',
),
...
```
This is how an example transaction looks without the option:
```beancount
2021-03-01 * "Kartenzahlung" "XY Supermarket"
Assets:DKB:EC -133.72 EUR
```
And this is the resulting transaction using `meta_code='code'`
```beancount
2021-03-01 * "XY Supermarket"
code: Kartenzahlung
Assets:DKB:EC -133.72 EUR
```
### Pattern-matching Transactions
It's possible to give the importer classes hints if you'd like them to include a
second posting based on specific characteristics of the original transaction.
For instance, if the payee or the description in a transaction always matches a
certain value, it's possible to tell the `ECImporter` or `CreditImporter` to
automatically place a second posting in the returned lits of transactions.
#### `ECImporter`
`ECImporter` accepts a `payee_patterns` argument, which should be a list of
`(pattern, account)` tuples.
```python
CONFIG = [
ECImporter(
IBAN_NUMBER,
'Assets:DKB:EC',
currency='EUR',
file_encoding='utf-8',
payee_patterns=[
('REWE Filialen', 'Expenses:Supermarket:REWE'),
('NETFLIX', 'Expenses:Online:Netflix'),
],
),
```
#### `CreditImporter`
`CreditImporter` accepts a `description_patterns` argument, which should be a
list of `(pattern, account)` tuples.
```python
CONFIG = [
CreditImporter(
CARD_NUMBER,
'Assets:DKB:Credit',
currency='EUR',
file_encoding='utf-8',
description_patterns=[
('REWE sagt Danke', 'Expenses:Supermarket:REWE'),
('NETFLIX', 'Expenses:Online:Netflix'),
],
)
```
## FAQ
```sh
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.6+ and [Poetry] installed.
1. 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`.
[Beancount]: http://furius.ca/beancount/
[config file]: https://beancount.github.io/docs/importing_external_data.html#configuration
[DKB]: https://www.dkb.de
[Poetry]: https://python-poetry.org/
[this guide]: https://beancount.github.io/docs/importing_external_data.html
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7,<4.0 | Python |
نحوه نصب
نصب پکیج whl beancount-dkb-0.9.0:
pip install beancount-dkb-0.9.0.whl
نصب پکیج tar.gz beancount-dkb-0.9.0:
pip install beancount-dkb-0.9.0.tar.gz