Skip to main content

Utilities enhancing hledger

Project description

coverage report pipeline status Downloads

🛠️ 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

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:

asciicast

📦 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 just pip install ...

This package is also available in the AUR as python-hledger-utils-git.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hledger-utils-1.1.1.tar.gz (25.8 kB view hashes)

Uploaded Source

Built Distribution

hledger_utils-1.1.1-py3-none-any.whl (12.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page