dinero-rs

Crates.iodinero-rs
lib.rsdinero-rs
version0.33.3-dev
sourcesrc
created_at2021-01-16 13:07:15.15671
updated_at2021-12-29 15:49:14.634849
descriptionA command line ledger tool
homepagehttps://github.com/frosklis/dinero-rs
repositoryhttps://github.com/frosklis/dinero-rs
max_upload_size
id342784
size339,493
Claudio Noguera (frosklis)

documentation

README

Build status codecov crates.io Crates.io dependency status

Dinero (spanish for money) is a command line tool that can deal with ledger files, as defined by John Wiegley's wonderful ledger-cli.

Quickstart

Install

If Rust and cargo are available in your system, the easiest way to get dinero-rs is by installing the crate:

cargo install dinero-rs
  • Installation for Windows
  • Installation for Mac
  • Installation for Linux

First steps

Dinero uses double entry accounting. Store your journal files in ledger files. The main item is a transaction, which in its basic form looks something like this:

; This is a comment
; A date followed by a description identifies the beginning of a transaction
2021-02-01 Buy fruit
     Expenses:Groceries          7.92 EUR
     Assets:Checking account             ; you can leave this blank, dinero balances the transactions for you

After that, you can issue all the commands you want and combine them with options to have complete control over your finances!

The most basic ones are:

# Get a balance report: How much is there in every account 
dinero bal -f myledger.ledger

# Get a list of transactions
dinero reg -f myledger.ledger

Features

Currently supported are:

  • Balance reports
  • Register reports
  • Account and payees reports
  • Automated transactions
  • Multicurrency transactions
  • Currency conversion

Report filtering by account name and by date.

Motivation

I use ledger-cli extensively for my personal finances. My goal is to be able to run all the commands I use the most with my own tool while at the same time learning Rust.

Run dinero --help for a list of available commands and options.

If you use this software and want to say thanks, feel free to buy me a coffee.

Commit count: 817

cargo fmt