bankreport's Introduction

bankreport

Installation

Via pip: pip install bankreport
From local git checkout: make install

Usage

Usage: bankreport [OPTIONS] [SRC]...

Options:
  -f, --format [tsv|csv|txt|pkl|html]
  --dedup / --no-dedup            Deduplicate entries
  --sort TEXT                     Comma sepearated list of fields to sort the output by
  -x, --exclude TEXT              Exclude records containing the provided string
  --rules TEXT                    File containing classification rules
                                  Schema: <regex>\t<category>

  -v, --verbose                   Debug output
  --help                          Show this message and exit

Output Columns

Account -- E.g. comdirekt/giro; comdiekt/visa
Date -- isoformatted date
Text -- "Buchungstext"
Value -- Value of transactions (typically in EUR)
Category -- Inferred category from rules file

Example Usage

Download various csv files from ComDirekt online-banking into ./csv
Rename ComDirekt CSV files to have extension .cd.csv
Run bankreport as:
- bankreport ./csv/* to write a well-defined unified tsv file to stdout
- bankreport -f html ./csv/* > out.html & open out.html to view HTML formatted table
- bankreport ./csv/* --rules rules.tsv | q -t -H -O 'select Category, sum(Value) from - group by Category' to show category totals (using q(1)).

Supported Banking Formats

Banking formats are inferred from the file extension, as to allow mixed files in a single directory. Unfortunately, the supported banks do not use consistent file extensions by themselves, so the files have to be manually renamed to have the correct extension.