#currency #money #bank #international

qsv_currency

A library for representing international currencies

1 unstable release

Uses old Rust 2015

0.5.0 Dec 28, 2021

#4 in #bank

Download history 148/week @ 2022-06-09 74/week @ 2022-06-16 30/week @ 2022-06-23 140/week @ 2022-06-30 49/week @ 2022-07-07 73/week @ 2022-07-14 75/week @ 2022-07-21 118/week @ 2022-07-28 263/week @ 2022-08-04 101/week @ 2022-08-11 140/week @ 2022-08-18 90/week @ 2022-08-25 88/week @ 2022-09-01 146/week @ 2022-09-08 131/week @ 2022-09-15 58/week @ 2022-09-22

434 downloads per month
Used in qsv

MIT license

45KB
1K SLoC

Rust Currency Library

A very small library, providing a way to represent currencies in Rust.

This is a fork of https://github.com/Tahler/currency-rs, pulling in pending PRs for currency strings (e.g. "USD, EUR, etc." - not just single character symbols - "$, €, etc.") and serde support.

It also upgrades the num dependency from 0.1.32 to 0.4.0.

This fork was primarily created for the qsv CSV data-wrangling toolkit.


lib.rs:

A Currency is a combination of an optional character (Option<char>``) and a big integer (BigInt`).

Common operations are overloaded to make numerical operations easy.

Perhaps the most useful part of this crate is the Currency::from_str function, which can convert international currency representations such as "$1,000.42" and "£10,99" into a usable Currency instance.

Example

extern crate qsv_currency;

fn main() {
    use qsv_currency::Currency;

    let sock_price = Currency::from_str("$11.99").unwrap();
    let toothbrush_price = Currency::from_str("$1.99").unwrap();
    let subtotal = sock_price + toothbrush_price;
    let tax_rate = 0.07;
    let total = &subtotal + (&subtotal * tax_rate);
    assert_eq!(format!("{}", total), "$14.95");
}

Limitations

This crate cannot lookup conversion data dynamically. It does supply a convert function, but the conversion rates will need to be input by the user.

This crate also does not handle rounding or precision. Values are truncated during multiplication, division, and extra precision in a parse (such as gas prices).

Dependencies

~520–710KB
~15K SLoC