12 stable releases (4 major)
5.1.1 | Apr 21, 2022 |
---|---|
5.1.0 | Jan 24, 2022 |
4.1.0 | Jan 18, 2022 |
3.1.0 | Apr 30, 2020 |
1.0.1 | Oct 22, 2018 |
#321 in Parser implementations
39 downloads per month
Used in ledger-utils
73KB
2K
SLoC
ledger-parser
Rust library for parsing Ledger-cli input files.
File format
Only a subset of the ledger-cli's file format is implemented.
Supported elements:
-
Line comments (starting with:
; # % | *
) -
Inline comments (starting with
;
) -
Transaction headers with format (minimum two spaces or one tab between
DESC
andNOTE
):DATE[=EDATE] [*|!] [(CODE)] DESC [; NOTE]
-
Transaction postings with format (minimum two spaces or one tab between
ACCOUNT
andAMOUNT
):ACCOUNT [AMOUNT] [= BALANCE] [; NOTE]
- Virtual accounts are supported
-
AMOUNT
can be combined with lot and commodity prices ({}, {{}}, @, @@) -
Commodity prices with format:
P DATE SYMBOL PRICE
-
Command directives:
include
Example
Parsing:
let ledger = ledger_parser::parse(r#"; Example 1
2018-10-01=2018-10-14 ! (123) Description
; Transaction comment
TEST:Account 123 $1.20
; Posting comment
TEST:Account 345 -$1.20"#)?;
Serializing:
use ledger_parser::{ Serializer, SerializerSettings };
println!("{}", ledger);
println!("{}", ledger.to_string_pretty(&SerializerSettings::default().with_indent("\t")));
See also
- ledger-utils - ledger-cli file processing Rust library, useful for calculating balances, creating reports etc.
Dependencies
~2.5MB
~46K SLoC