hledger/examples/debconf/README.md

DebConf ledgers

DebConf has done their accounting with Ledger since 2017.
Eg: https://salsa.debian.org/debconf-team/public/data/dc25/-/tree/main/budget
Here are some scripts and notes to help view them with hledger.

Each year has its own repo, and the repos are big.
To clone just the accounting data for all years: make
Or to clone just a few recent years: make recent

Some patches for hledger readability will be applied; those might need updating from time to time.
To check hledger readability: make check-hledger
To check ledger readability: make check-ledger

For convenient reporting, a top-level journal file is created for each year’s repo.
These also include the forex.db files, allowing currency conversion (when rates exist; you might need to fetch more).

The hledger.conf file sets a few non-essential defaults when you are in this directory.
Here are hledger’s manual and other docs.

Report examples

Single year reports:

• hledger -f 2025.ledger is
• hledger -f 2025.ledger is -V
• hledger -f 2025.ledger is -VQSTt --drop 1

The all.ledger file reads all the downloaded repos at once:

• hledger -f all.ledger is -1 -YTN
• hledger -f all.ledger is -1 -YT -X USD

make hledger-'ARGS' runs a hledger command in each downloaded repo:

• make hledger-accounts
• make hledger-stats | grep 'Txns '
• make hledger-'bs -2'
• make hledger-'is -2