command line accounting tool
As a former CPA, I could not resist building my own accounting system.
yaml files as data storecsv files to yaml formatCODE_OF_CONDUCT.md for fundamental guidelinescargo install rust_ledger
We distribute binaries for the above platforms. See releases for a complete list by version.
Additionally, we currently ship binaries through the following package managers:
Alternatively, clone this repo and do the following:
cargo build --release to compile the binary/target/release and copy the rust_ledger binary in your path: /usr/binrust_ledger --help will provide a menu of all available commands and optional arguments.
```bash
rust_ledger
USAGE: rust_ledger [SUBCOMMAND]
FLAGS: -h, --help Prints help information -V, --version Prints version information
SUBCOMMANDS: account account module balance balance module csv csv module help Prints this message or the help of the given subcommand(s) register register module ```
rust_ledger COMMAND -f LEDGER_FILE_PATH
LEDGERFILEPATH (denoted by -f) - relative path to location of yaml ledger file
RLEDGER_FILE in lieu of specifying whenever the program is invoked.-f is provided with a file path the file provided will be used instead of any RLEDGER_FILE set.
RLEDGER_FILE=~/rledger.yaml rust_ledger balance
RLEDGER_FILE can be set as a system or user environment variable.
export RLEDGER_FILE=$HOME/rledger.yaml
RLEDGER_FILE - Path to rledger file. ex: RLEDGER_FILE=~/rledger.yaml
NO_COLOR - Disables color output. ex: NO_COLOR=true
Transactions can be expressed in two different ways. One is a "simplified" format for transactions that only impact two accounts:
yaml
- date: 2020-01-01
amount: 200
offset_account: liability:credit_card_amex
description: grocery store
account: expense:expense_general
The sign (debit / credit) associated with the offset_account value is the opposite of the sign of the value contained in amount field.
In the above example transaction, since expense_general was debited by 200, the credit_card_amex account will be credited by the same amount.
Transactions that involve more than two accounts are expressed in the following manner:
yaml
- date: 2020-01-01
description: grocery store
transactions:
- amount: 20
account: expense:general
- amount: 180
account: expense:grocery
- amount: -200
account: liability:credit_card_amex
Transactions that only involve two accounts can also be expressed in the above format.
cargo test``` rust_ledger-account account module
USAGE: rust_ledger account [OPTIONS]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-f, --filename
```
asset:cashchecking asset:cashsavings liability:creditcardamex equity:equity expense:grocery expense:general expense:mortgage income:general ```
``` rust_ledger-balance balance module
USAGE: rust_ledger balance [OPTIONS]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-f, --filename
```
asset asset:cashchecking $ -400.00 asset:cashsavings $ 1,000.00 liability liability:creditcardamex $ -455.00 equity equity:equity $ -3,500.00 expense expense:grocery $ 635.00 expense:general $ 1,020.00 expense:mortgage $ 2,000.00 income income:general $ -300.00
check 0 ```
``` rust_ledger-register register module
USAGE: rust_ledger register [OPTIONS]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-f, --filename
```
2019-12-31 weekly groceries expense:grocery $ 455.00 2019-12-31 weekly groceries liability:creditcardamex $ -455.00 2020-01-01 mortage expense:mortgage $ 2,000.00 2020-01-01 mortage asset:cashchecking $ -2,000.00 2020-01-01 stuff expense:general $ 1,000.00 2020-01-01 stuff asset:cashsavings $ -1,000.00 2020-01-01 grocery store expense:general $ 20.00 2020-01-01 grocery store expense:grocery $ 180.00 2020-01-01 grocery store asset:cashchecking $ -200.00 2020-01-01 donut sale to dale asset:cashchecking $ 300.00 2020-01-01 donut sale to dale income:general $ -300.00 ```
``` rust_ledger-csv csv module
USAGE: rust_ledger csv [OPTIONS]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-c, --csv
csv files to yaml format expected by rust_ledger.-f, -o, and s arguments. These include the rust_ledger file location (unless specified via environment variable),
csv file location and account offset, respectively.s argument) would be the offset transaction that the csv transactions should be posted against.description fields and will populate the appropriate expense/income accounts
for any matches. Non-matches will use a default of expense:general or income:general, which is determined based on the sign of the amount field
contained in the transaction.csv file into the tool, you must rename the columns in the first line of the csv file in the following schema:
"date","transaction","name","memo","amount".yaml file formatyaml file can be found at examples/example.yamlyaml files in the following format:```yaml accounts: - account: amount:
transactions: - date: amount: description: account: offset_account: - date: description: transactions: - amount: account: - amount: account: ```
The ledger format schema is purposely lightweight. The only requirements are as follows:
account field should be expressed in the following format: account_classification:account_name.amount field should be a number. It can include up to two (2) decimal points.date field should be in the following format: YYYY-MM-DD.