Beancount file loader with include resolution.

This crate handles loading beancount files, resolving includes, and collecting options. It builds on the parser to provide a complete loading pipeline.

Features

• Recursive include resolution with cycle detection
• Options collection and parsing
• Plugin directive collection
• Source map for error reporting
• Push/pop tag and metadata handling
• Automatic GPG decryption for encrypted files (.gpg, .asc)

Example

use rustledger_loader::Loader;
use std::path::Path;

let result = Loader::new().load(Path::new("ledger.beancount"))?;
for directive in result.directives {
    println!("{:?}", directive);
}

rustledger-loader

Beancount file loader with include resolution, options parsing, and binary caching.

Features

• Recursive include directive resolution
• Option parsing and validation
• Plugin directive collection
• Binary cache for faster subsequent loads
• Path traversal protection

Example

use rustledger_loader::load_file;

let result = load_file("ledger.beancount")?;

println!("Loaded {} directives", result.directives.len());
println!("Options: {:?}", result.options);
println!("Errors: {:?}", result.errors);

Cargo Features

• cache (default) - Enable rkyv-based binary caching for faster loads

License

GPL-3.0