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 debit and credit transactions to respective account types.
- Debit:
Expenses:JP:Unknown:NameOfInstitution
- Credit:
Income:JP:Unknown:NameOfInstitution
- Debit:
What these scripts can not (yet) do:
- Label transactions with different sub-accounts, e.g.,
Expenses:JP:Food:Grocery
orExpenses:JP:Food:Restaurant
.
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
Built Distribution
Close
Hashes for beancount_multitool-0.3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7d8c82dc4c7181e73b40f1e578fe23eb8dae9260d69a505447a35ce997f2dd53 |
|
MD5 | cd0de7e5cfe36b00748be0fcac788098 |
|
BLAKE2b-256 | 4f3710169f480b34eb6625df22c43985692aec61fdf4e16fab25b30fca9cae35 |
Close
Hashes for beancount_multitool-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 983a201d3e9a933f6da120ff3b1e320664712568a9bc4d600702b887161c9d20 |
|
MD5 | 4108c4edc8c97620247d3c5ffc96948f |
|
BLAKE2b-256 | 11b1fc939bc48ec9a13cd767a2560905a4031bc31ae80d508ecba13ac3d9bc74 |