- Zig 85%
- JavaScript 10%
- Nix 2%
- CSS 1%
- HTML <1%
- 1 more language <1%
csv2journal #
Converts bank CSV exports into hledger journals.
Warning
Project status: This is early experimental software. I'm just starting to use it and it will change often. I do not yet advise to use it to anyone else.
Classification rules are named and order-independent. Every data row must match exactly one rule;
zero matches and multiple matches are errors rather than things resolved by declaration order. Rules
are also checked against history: within the input root, bank/2026.csv pairs with the colocated
bank/2026.csv.journal, and current rules must still reproduce every journal already approved. A rule
change that would alter past output is caught before anything is written.
The sole CSV without a journal beside it is the one being imported.
Status #
Milestone one is specified and designed. Not yet implemented.
Documentation #
| Document | Contents |
|---|---|
| docs/VISION.md | Product principles |
| docs/REQUIREMENTS.md | Milestone-one behaviour |
| docs/DESIGN_M1.md | Technical design |
| docs/PROCESS.md | How this project is developed |
| docs/PLAN_M1.md | Build order and tasks |
| docs/yaml/ | Example configuration |
Planned interface #
csv2journal check MANIFEST
csv2journal convert MANIFEST
csv2journal interactive MANIFEST [--listen HOST:PORT]
check validates without writing. convert validates, then atomically creates the one missing
journal. interactive serves a local rule editor on 127.0.0.1:8080, and logs to stdout;
CSV2JOURNAL_LOG=debug adds a line per connection, request and evaluation step, with timings.
Building #
Zig 0.17.0, packaged as a Nix flake. hledger 1.52.3 is a test-only dependency; it is never invoked at runtime.