beancount-format

Rust formatter for Beancount files with a reusable core library, a small CLI, and optional Python bindings.

Usage

cli/pypi package

• Format files in place (default): beancount-format path/to/file.beancount
• Check without modifying (exit 1 if reformat needed): beancount-format --check path/to/file.beancount

Config

The CLI auto-detects pyproject.toml from the working directory or provided paths and merges settings with any CLI overrides.

[tool.beancount-format]
line-width = 70
indent-width = 2
new-line-kind = "lf"
compact-balance-spacing = false

• Can be overridden from args: --line-width 80 --indent-width 4 --new-line lf --compact-balance-spacing

dprint

A dprint plugin is published in npm and can be fetched from jsDelivr directly:

{
  "plugins": [
    "https://cdn.jsdelivr.net/npm/@trim21/dprint-plugin-beancount@latest/plugin.wasm"
  ]
}

Crates

• crates/beancount-formatter: core library containing the formatter and configuration.
• crates/beancount-formatter-cli: CLI wrapper around the formatter library.
• crates/beancount-formatter-py: Python bindings built with PyO3/maturin.

Development

• Build CLI: cargo build -p beancount-formatter-cli --release
• Run tests: cargo test --workspace
• Format code: cargo fmt --all