Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/adept/hledger-sankey

Python3 (pandas, plotly) script to plot income vs expense money flows from hledger ledger
https://github.com/adept/hledger-sankey

Last synced: about 1 month ago
JSON representation

Python3 (pandas, plotly) script to plot income vs expense money flows from hledger ledger

Awesome Lists containing this project

README

        

# hledger-sankey
A python3 script (that uses pandas and plotly) to plot three graphs:

- treemap graph of all expenses

- sankey graph of income vs expense money flows

- sankey graph of money flows between income, expenses, assets and liabilities account categories

# Usage it
Run `python3 sankey.py example.journal`, and this should open the page with interactive graphs in your browser.

# Try it
Repository contains `sankey.csv` generated out of slighly edited `Cody.journal` from hledger examples.

# Assumptions
This is a proof of concept, and it is a bit rough round the edges.

Patches to make it more robust are very welcome

Script makes a bunch of assumptions:

- `hledger` is in your path

- income, expenses, assets and liabilities categories in
your chart of accounts are named exactly this

- your balances could be obtained in '£' via `--cost --value=then,£` flags for `hledger balance`.

If these assumptions do not hold for you, edit the script.

# How would it look like
![Graphs generated from example.journal](example.png)