https://github.com/sekunho/moneyman

💱 A crusty currency converter
https://github.com/sekunho/moneyman

currency-converter rust-lang

Last synced: 6 months ago
JSON representation

💱 A crusty currency converter

• Host: GitHub
• URL: https://github.com/sekunho/moneyman
• Owner: sekunho
• License: bsd-3-clause
• Created: 2023-05-03T04:21:56.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-13T16:44:24.000Z (8 months ago)
• Last Synced: 2025-04-13T05:05:27.773Z (6 months ago)
• Topics: currency-converter, rust-lang
• Language: Rust
• Homepage: https://docs.rs/moneyman
• Size: 1.99 MB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# 💱 moneyman

![Crates.io](https://img.shields.io/crates/v/moneyman?label=moneyman&style=flat-square)

![docs.rs](https://img.shields.io/docsrs/moneyman?style=flat-square)

![Crates.io](https://img.shields.io/crates/v/moneyman_cli?label=moneyman_cli&style=flat-square)

A crusty currency converter

![moneyman_cli](./assets/cli.png)

## Example

```

$ moneyman convert 50 --from EUR --to PHP --on 2023-05-06 --fallback

50 EUR -> 3044.5833333333350 PHP on the date 2023-05-06

```

`moneyman` is also available as a library.

```rust

use std::path::PathBuf;

use chrono::NaiveDate;

use rust_decimal_macros::dec;

use rusty_money::{iso, Money};

fn main() {

    // Choose where to save the historical data files.

    let data_dir: PathBuf = dirs::home_dir()

        .and_then(|home_dir| Some(home_dir.join(".moneyman")))

        .expect("need a home directory");

    // Fetches the historical data from European Central Bank, and creates an

    // exchange store.

    let store = moneyman_core::ExchangeStore::sync(data_dir).expect("failed ze sync");

    let amount_in_usd = Money::from_decimal(dec!(6500), iso::USD);

    let date = NaiveDate::from_ymd_opt(2023, 5, 4).expect("ok date");

    // Converts 6,500.00 USD to EUR

    let actual = store.convert_on_date(amount_in_usd, iso::EUR, date);

    let expected = Money::from_decimal(dec!(5869.6044789597254831135994221), iso::EUR);

    // Shouldn't explode? :)

    assert_eq!(actual, expected);

}

```

## Details

`moneyman` extends on `rusty-money` as it already provides a lot of the things like

`Money`, `Currency`, `ExchangeRate`, and `Exchange`. However, it does not

provide any data to actually convert currency. For historical data, `moneyman`

uses the European Central Bank, and saves its data to its own local data store.

## Caveat

One important thing to know is that `ANY_OTHER_CURRENCY` -> EUR is computed with

`1/` since ECB only contains the

EUR -> `ANY_OTHER_CURRENCY` rates, not vice versa. This [dividing] is most

probably not the behavior observed by RealWord™ currency exchanges. So this

only serves as an approximation at best.