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.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 810a31f5bb65c1bc2180102b7f910142e7a666bd421aeced9f9ce1801d7524fb |
|
MD5 | 9e71fae1e50131effb55b0ab2c0ded8c |
|
BLAKE2b-256 | 5016cd2f8620d215d72fb05428f56ea725a425ef92a9c14e057b547edb2b6499 |
Close
Hashes for beancount_multitool-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85dd400377deca2b2911a97e16f380f4887605524974319a595144001182eb4c |
|
MD5 | b653320b82444e4140aae676b04a9f17 |
|
BLAKE2b-256 | 4bfbb7d27a6c00c7db5446e2c18dda8d744ac1a5b51a8922a06edd757e43d600 |