A CLI tool that converts financial data to Beancount files
Project description
Beancount Multitool
Beancount Multitool is a command-line-interface (CLI) tool that converts financial data from financial institutions to Beancount files.
The following institutions are supported:
What these scripts can do:
- Read raw CSV files downloaded from each institution's website.
- Label transactions with different sub-accounts, e.g.,
Expenses:JP:Food:Grocery
orExpenses:JP:Food:Restaurant
.- Documentation is incoming.
- Label unknown transactions to respective account types.
- Debit:
Expenses:JP:Unknown:NameOfInstitution
- Credit:
Income:JP:Unknown:NameOfInstitution
- Debit:
What these scripts can not (yet) do:
- To be added.
Installation:
pip install beancount-multitool
Usage:
bean-mt --help
Usage: bean-mt [OPTIONS] NAME CONFIG DATA
Read financial data and output a Beancount file.
NAME is the name of the financial institution. See Note below for a list of
supported names.
CONFIG is a .toml file with run-time configurations, e.g. config.toml.
DATA is the raw financial data downloaded from NAME, e.g. input.csv.
Options:
--output PATH Resulting Beancount file
--version Show the version and exit.
--help Show this message and exit.
Note: supported names of financial institutions: ['ja_bank', 'rakuten_bank',
'rakuten_card', 'shinsei_bank']
Example:
bean-mt rakuten_bank config.toml 2024-01.csv --output 2024-01.bean
Workflow:
- Download the raw CSV files from a financial institutions.
- Run
bean-mt
. - Include the
output.bean
file in my ledger. - Manually edit that Beancount file to my needs.
config.toml:
There is a default config.toml per financial institutions. Examples are in the test data folder.
Requirements
- Python 3.9 or higher.
More
License
MIT License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
beancount_multitool-0.4.0.tar.gz
(10.6 kB
view hashes)
Built Distribution
Close
Hashes for beancount_multitool-0.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 159bc2cebeb266e864b33543cb08a77d256974aae8f3c3007593b6c146f7be64 |
|
MD5 | 8d624c204b8136870e9637f2359b48c7 |
|
BLAKE2b-256 | b020ec656a16dedeb9b5880ea70f3b707a76711fd5a8ec89ba419130b6872411 |
Close
Hashes for beancount_multitool-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d4f78a7819541f440da412a10f5e0c8c32ba07ebb7eb70d5fcfc8b2847c347e8 |
|
MD5 | ad967c323004b47b42b8cc585fa3e2ff |
|
BLAKE2b-256 | 6127327b9940beb69d2f2dec7b3182c9a2101ba3cb42a8f02b7f4a4107b1622e |