Accounting Example

Using hledger

General Usage

Plain Text Accounting Workshop

hledger Manual

General Structure

.
├── 2024
│   ├── aliased.ledger
│   ├── book.ledger
│   └── postings.ledger
├── book.ledger
└── meta
    ├── coicop-2018.ledger
    └── commodities.ledger

book.ledger

• Main entry point for the general ledger, or each year's ledger

postings.ledger

• Actual double-entry transactions
• should always pass --strict
• should optimally always pass all checks

aliased.ledger

• Because of how hledger works, we create a separate file to handle aliases
• This should provide a more readable accounts output

Running all checks

pre-commit run --all-files

Checking that any year's book passes strict checks

hledger bal --strict -f 2024/book.ledger

Checking that any year's book passes all checks

hledger check --strict ordereddates payees tags recentassertions uniqueleafnames -f 2024/book.ledger

Using Git-Agecrypt

Git-agecrypt is a rust-written file encryption git extension.

git-agecrypt allows one to upload files to public platforms (or platforms where privacy is not guaranteed, such as private repos) in an encrypted manner.

For the purposes of this example, a pair of Ed25519 private-public keys is provided in secrets.

However in your own version you should not at all consider providing this key-pair publicly.

Please refer to the git-agecrypt documentation.

🚨 IMPORTANT

For encryption to occur the file needs to:

• 🚨 Have recipients detailed in git-agecrypt.toml
• 🚨 Be filtered and diffed by git-agecrypt in .gitattributes

Note on decrypting

The git-agecrypt docs are not amazing.

To decrypt files after cloning, add an identity.

For example: git-agecrypt config add -i ~/.ssh/id_ed25519.

This identity needs to be a recipient of the particular files you want decrypted.

Then, to decrypt run git checkout HEAD -- .

For example, in this repo:

git-agecrypt config add -i $"($env.PWD)/secrets/id_ed25519"
git checkout HEAD -- .

This does not need to be done ever again, as git pull will automatically decrypt the file in the future.