Add money: statement-driven personal finance tracker

A data directory holds one folder per account. Statements dropped into
those folders are parsed into a rebuildable SQLite index, categorised by
ordered glob rules in rules.toml, and browsed or hand-tagged in a Bubble
Tea TUI. Movements between the user's own accounts are marked as
transfers by the same rules and excluded from spending totals.

Manual tags and transfer marks are stored separately from the rule-derived
ones and always win, so editing rules.toml and re-running retag never
destroys hand edits.

Parsers are pluggable. Three are ported from the Python extractors they
replace -- nlb and traderepublic read PDFs via pdftotext -layout, revolut
reads the CSV export -- alongside a configurable-column CSV parser and a
cmd parser that shells out to an external script.

Both ports fix two latent bugs in the originals: the sign character class
rejected the typographic minus U+2212 that some PDF fonts emit, and NLB's
hardcoded continuation indent broke when pdftotext compressed runs of
spaces, so the threshold is now measured from the description column.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-09 00:37:20 +02:00
co-authored by Claude Opus 5
commit b0026c5a79
30 changed files with 5048 additions and 0 deletions
+53
View File
@@ -0,0 +1,53 @@
package parser
import (
"bytes"
"context"
"fmt"
"os/exec"
"strings"
"time"
)
// pdfToTextTimeout bounds extraction so a malformed PDF cannot wedge an import.
const pdfToTextTimeout = 2 * time.Minute
// pdfToText renders a PDF as text with the original column positions
// preserved, which is what the statement parsers key off.
//
// This shells out to poppler's pdftotext rather than decoding the PDF in Go:
// the layout reconstruction it does is the whole reason the column-based
// parsers work, and no Go library matches it.
func pdfToText(path string) (string, error) {
ctx, cancel := context.WithTimeout(context.Background(), pdfToTextTimeout)
defer cancel()
cmd := exec.CommandContext(ctx, "pdftotext", "-layout", path, "-")
var stdout, stderr bytes.Buffer
cmd.Stdout = &stdout
cmd.Stderr = &stderr
if err := cmd.Run(); err != nil {
if ctx.Err() == context.DeadlineExceeded {
return "", fmt.Errorf("pdftotext timed out after %s on %s", pdfToTextTimeout, path)
}
if errors := strings.TrimSpace(stderr.String()); errors != "" {
return "", fmt.Errorf("pdftotext %s: %w: %s", path, err, errors)
}
if _, lookErr := exec.LookPath("pdftotext"); lookErr != nil {
return "", fmt.Errorf("pdftotext is not installed (it ships with poppler-utils): %w", lookErr)
}
return "", fmt.Errorf("pdftotext %s: %w", path, err)
}
return stdout.String(), nil
}
// pages splits pdftotext output on form feeds.
func pages(text string) []string {
return strings.Split(text, "\f")
}
// indent counts the leading spaces of a line.
func indent(line string) int {
return len(line) - len(strings.TrimLeft(line, " "))
}