rustledger_parser/
lib.rs

1//! Beancount parser using chumsky parser combinators.
2//!
3//! This crate provides a parser for the Beancount file format. It produces
4//! a stream of [`Directive`]s from source text, along with any parse errors.
5//!
6//! # Features
7//!
8//! - Full Beancount syntax support (all 12 directive types)
9//! - Error recovery (continues parsing after errors)
10//! - Precise source locations for error reporting
11//! - Support for includes, options, plugins
12//!
13//! # Example
14//!
15//! ```ignore
16//! use rustledger_parser::parse;
17//!
18//! let source = r#"
19//! 2024-01-15 * "Coffee Shop" "Morning coffee"
20//!   Expenses:Food:Coffee  5.00 USD
21//!   Assets:Cash
22//! "#;
23//!
24//! let (directives, errors) = parse(source);
25//! assert!(errors.is_empty());
26//! assert_eq!(directives.len(), 1);
27//! ```
28
29#![forbid(unsafe_code)]
30#![warn(missing_docs)]
31
32mod error;
33pub mod logos_lexer;
34mod span;
35mod token_input;
36mod token_parser;
37
38pub use error::{ParseError, ParseErrorKind};
39pub use span::{Span, Spanned};
40
41use rustledger_core::Directive;
42
43/// Result of parsing a beancount file.
44#[derive(Debug)]
45pub struct ParseResult {
46    /// Successfully parsed directives.
47    pub directives: Vec<Spanned<Directive>>,
48    /// Options found in the file.
49    pub options: Vec<(String, String, Span)>,
50    /// Include directives found.
51    pub includes: Vec<(String, Span)>,
52    /// Plugin directives found.
53    pub plugins: Vec<(String, Option<String>, Span)>,
54    /// Parse errors encountered.
55    pub errors: Vec<ParseError>,
56}
57
58/// Parse beancount source code.
59///
60/// Uses a fast token-based parser (Logos lexer + Chumsky combinators).
61///
62/// # Arguments
63///
64/// * `source` - The beancount source code to parse
65///
66/// # Returns
67///
68/// A `ParseResult` containing directives, options, includes, plugins, and errors.
69pub fn parse(source: &str) -> ParseResult {
70    token_parser::parse(source)
71}
72
73/// Parse beancount source code, returning only directives and errors.
74///
75/// This is a simpler interface when you don't need options/includes/plugins.
76pub fn parse_directives(source: &str) -> (Vec<Spanned<Directive>>, Vec<ParseError>) {
77    let result = parse(source);
78    (result.directives, result.errors)
79}
rustledger_parser/lib.rs

rustledger_parser/
lib.rs
