Crate dinero

Dinero (spanish for money) is a command line tool that can deal with ledger files. It is inspired but not a port of John Wiegley’s wonderful ledger-cli.

Note that the crate name is dinero-rs but the executable is dinero

Getting started

The input files

dinero understands ledger files, which are human-readable journal files. A journal is composed of directives that tell dinero about miscellaneous things like accounts, payees or commodities and transactions, which are each of the journal entries. A transaction looks like this:

2021-02-28 * Flights to Rome | Alitalia
    Expenses:Travel             153.17 EUR
    Assets:Checking account    -153.17 EUR

A transaction (if it doesn’t include virtual postings) always has to be balanced, meaning the total amount of a transaction has to be zero. dinero knows this, so elliding some information is allowed, like so:

2021-02-28 * Flights to Rome | Alitalia
    Expenses:Travel             153.17 EUR
    Assets:Checking account

Or you can even do multi-currency, the conversion will be implicitely done. It supports unicode too, so this is valid as well:

2021-02-28 * Flights to Rome | Alitalia
    Expenses:Travel             153.17 €
    Assets:Checking account     $-180

The commands

Given an input file, reports are extracted with commands, like so:

# A balance report
dinero bal -f my_journal.ledger

# A balance report in euros
dinero bal -f my_journal.ledger -X €

# Print all the registers
dinero reg -f my_journal.ledger

Modules

commands

filter

models

parser

Parser module

Structs

CommonOpts

Command line options

List

A generic container with some search capabilities

Functions

run_app

Entry point for the command line app