11# Beancount Multitool
22
33![ Tests badge] ( https://github.com/rlan/beancount-multitool/actions/workflows/tests.yml/badge.svg )
4- ![ python version required] ( https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Frlan%2Fbeancount-multitool%2Fmain%2Fpyproject.toml )
4+ ![ pypi version] (https://img.shields.io/pypi/v/beancount-multitool
5+ )
6+ ![ python version required] (https://img.shields.io/pypi/pyversions/beancount-multitool
7+ )
58![ static coverage badge] ( https://img.shields.io/badge/Coverage-97%25-blue )
69
710Beancount Multitool is a command-line-interface (CLI) tool that converts financial data from financial institutions to Beancount files.
@@ -25,15 +28,25 @@ What these scripts __can not__ (yet) do:
2528
2629* Label transactions with different sub-accounts, e.g., ` Expenses:JP:Food:Grocery ` or ` Expenses:JP:Food:Restaurant ` .
2730
31+ Installation:
32+
33+ ``` sh
34+ pip install beancount-multitool
35+ ```
36+
2837Usage:
2938
39+ ``` sh
40+ bean-mt --help
41+ ```
42+
3043``` txt
31- $ bean-mt --help
3244Usage: bean-mt [OPTIONS] NAME CONFIG DATA
3345
3446 Read financial data and output a Beancount file.
3547
36- NAME is the name of the financial institution, e.g. RakutenBank.
48+ NAME is the name of the financial institution. See Note below for a list of
49+ supported names.
3750
3851 CONFIG is a .toml file with run-time configurations, e.g. config.toml.
3952
@@ -43,6 +56,9 @@ Options:
4356 --output PATH Resulting Beancount file
4457 --version Show the version and exit.
4558 --help Show this message and exit.
59+
60+ Note: supported names of financial institutions: ['ja_bank', 'rakuten_bank',
61+ 'rakuten_card', 'shinsei_bank']
4662```
4763
4864Example:
@@ -62,12 +78,6 @@ config.toml:
6278
6379There is a default config.toml per financial institutions. Examples are in the test [ data folder] ( ./tests/data/ ) .
6480
65- ## Installation
66-
67- ``` sh
68- pip install beancount-multitool
69- ```
70-
7181## Requirements
7282
7383* Python 3.9 or higher.
0 commit comments