https://github.com/raed667/dinero

Dinero is a Rust port of Dinero.js (unstable)
https://github.com/raed667/dinero

dinero money rust rust-crate rust-lang rust-library rustlang

Last synced: about 21 hours ago
JSON representation

Dinero is a Rust port of Dinero.js (unstable)

• Host: GitHub
• URL: https://github.com/raed667/dinero
• Owner: raed667
• License: mit
• Created: 2022-10-12T19:46:12.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-28T10:27:51.000Z (almost 2 years ago)
• Last Synced: 2024-09-18T01:18:52.013Z (16 days ago)
• Topics: dinero, money, rust, rust-crate, rust-lang, rust-library, rustlang
• Language: Rust
• Homepage: https://crates.io/crates/dinero
• Size: 45.9 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

    

  





  

  

  

  

  

  

  

  >

  

  

  

  

  

  





  Dinero is a Rust port of Dinero.js

  


  Dinero lets you create, calculate, and format money in Rust.


  docs.rs/dinero



---

## 📦 Install

```sh

$ cargo add dinero

```

## ⚡️ Quick start

`Dinero` objects are minimal. The API is heavily inspired by `dinero.js` unless there is a more suitable Rust way to implement things.

```rust

use dinero::{api::add, currencies::USD, format::to_unit, Dinero};

// Create a Dinero object of value 8.5 USD (the default scale for USD is 2)

let d1 = Dinero::new(850, USD, None);

// Create a Dinero object of value 5 USD with a custom scale 3

let d2 = Dinero::new(5000, USD, Some(3));

// Add the 2 Dineros, the value is stored in the result Dinero without modifying d1 and d2

let result = add(&d1, &d2); // Similar API as Dinero.js

let result = d1 + d2; // Or you can use the standard operators

match result {

  Ok(value) => println!("{} USD", to_unit(value, None, None)), // 13.5 USD

  Err(_) => println!("Error adding d1+d2"),

}

```

## 🦀 Disclaimer

I'm using this project to learn about Rust. And I'm working my way through the language and the ecosystem.

Consider the current version of Dinero **unstable**. There will _definitely_ be breaking changes.

## 📜 License

[MIT](LICENSE)