Utilities enhancing hledger
Project description
🛠️ hledger
Utilities
This Python package extends hledger
the plaintextaccounting tool with some utilities.
✨ Features Added to hledger
hledger edit ...
: 📝 Editing hledger
Transactions in your $EDITOR
# Opens your EDITOR (or VISUAL) with only transactions in € that have a Berlin tag
# You can modify them as usual, if you save and quit the editor, the changes will be
# applied to the appropriate files
hledger edit cur:€ tag:location=Berlin
# Opens your EDITOR with all transactions
hledger edit
# If you don't have LEDGER_FILE set, you need to specify a journal file as usual:
hledger edit -f journal.hledger
# More examples and explanations:
hledger edit --help
This should work with pretty much any hledger query, just substitute hledger balance
or hledger register
etc. with 'hledger edit'. This is a neat way of quickly editing transactions you were just inspecting.
🎥 Check this screencast below to see hledger edit
in action:
hledger plot ...
: 📈 Plotting charts of hledger queries
# Open an interactive line chart of your assets with forecast (if available) and also save it as PNG
hledger plot -- balance ^Assets --daily --exchange=USD --historical --forecast -o assets.png
# Help, examples and configuration options (renaming, inverting, summing, styling, etc..)
hledger plot --help
📈 Example plot:
Note: Currently, only the balance
command output can be plotted. hledger-plot
has many options, check them out with hledger-plot --help
, most notably:
--sum
ming and--mean
ing columns by regex--multiply
ing a column with a factor- Filtering columns with
--drop
and--only
regexes --resample
ing to a different interval, e.g. 10 days with--resample 10d
- adding
--trend
s to (specific time periods of) columns and show slope in legend at configurable interval - grouping e.g. by quarter with
--groupby quarter
to compare quarters --style
ing depending on the account name
Consider converting your amounts to one currency (e.g. -X€
) and using --historical
. --stacked --barplot
s are also available.
See the doc/
folder for examples of hledger-plot
.
📦 Installation
# Install this package from PyPI:
pip install hledger-utils
# Install the latest development version:
pip install git+https://gitlab.com/nobodyinperson/hledger-utils
# Install from the repository root
git clone https://gitlab.com/nobodyinperson/hledger-utils
cd hledger-utils
pip install .
If that fails, try
python3 -m pip install --user ...
instead of justpip install ...
This package is also available in the AUR as python-hledger-utils-git
.
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
Hashes for hledger_utils-1.12.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9cd2321ff519f8811978fa5d750c27f1e473b0c97776718c2c3f42a2c947e1fc |
|
MD5 | 3ae22a34702794745b8d1387831edacd |
|
BLAKE2b-256 | 8bc6d5f5f72d4a453aedb086fe87d2f69826f89d15ba5d48586861694880bc8d |