# 🧮 pricing_kit
A flexible and extensible Rust library for calculating and managing product pricing, markups, commissions, and currency conversions.
## ✨ Features
- Define a **base (buy) price** and calculate **sell prices** based on:
- Flat amount markups
- Percentage markups
- Commissions in other currencies
- Support for **multi-currency** operations using exchange rates, ensuring **financial precision** with `Decimal` types.
- Support for **adjustments** such as:
- **Tax** calculations with percentage-based rates
- **Discounts** based on percentage
- **Fixed fees** with customizable currencies
- Clean and extensible API design, ready for future enhancements.
---
## ⚡ Quick Start
```rust
use pricing_kit::{Currency, CurrencyConverter, MarkupType, PricingDetail, dec};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let usd = Currency::new("USD", "American Dollar");
let idr = Currency::new("IDR", "Indonesian Rupiah");
let mut converter = CurrencyConverter::new();
converter.add_exchange_rate(&usd, dec!(1.0)); // Use dec! for Decimal
converter.add_exchange_rate(&idr, dec!(16500.0)); // Use dec! for Decimal
// Initialize PricingDetail with Decimal buy_price
let mut pricing = PricingDetail::new(dec!(100.0), usd.clone(), idr.clone());
// Directly set the `markup` field (no more `set_markup` method)
pricing.markup = Some(MarkupType::Amount {
value: dec!(3500.0), // Use dec! for Decimal
currency: idr.clone(),
});
// Call `apply_markup` and handle the Result
pricing.apply_markup(&converter)?;
println!("Pricing after markup:\n{:#?}", pricing);
Ok(())
}
```
---
## ⚡ Adjustment Feature Example
```rust
use pricing_kit::{Currency, CurrencyConverter, PricingDetail, PriceAdjustment, MarkupType, dec};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let usd = Currency::new("USD", "American Dollar");
let idr = Currency::new("IDR", "Indonesian Rupiah");
let mut converter = CurrencyConverter::new();
converter.add_exchange_rate(&usd, dec!(1.0)); // Use dec! for Decimal
converter.add_exchange_rate(&idr, dec!(16500.0)); // Use dec! for Decimal
// Initialize PricingDetail with Decimal buy_price
let mut pricing = PricingDetail::new(dec!(100.0), usd.clone(), idr.clone());
// Directly set the `markup` field
pricing.markup = Some(MarkupType::Percentage(dec!(20.0))); // Use dec!
pricing.apply_markup(&converter)?; // Handle Result
let adjustments = vec![
PriceAdjustment::Tax {
name: "Tax 11%".into(),
percentage: dec!(11.0), // Use dec!
},
PriceAdjustment::Discount {
name: "Discount".into(),
percentage: dec!(5.0), // Use dec!
},
PriceAdjustment::Fixed {
name: "Promo New Year".to_string(),
amount: dec!(10.0), // Use dec!
// Directly access `sell_currency` field
currency: pricing.sell_currency.clone(),
}
];
// Call `apply_adjustments` and handle the Result
pricing.apply_adjustments(&adjustments, &converter)?;
println!("==================\nAdjustment Pricing:\n{:#?}", pricing);
Ok(())
}
```
---
## 🎯 Crate Goals
This crate is designed to be:
- Easy to use for common e-commerce and fintech pricing scenarios
- **Accurate**, currency-aware, and reliable in financial calculations through explicit `Decimal` usage.
- Ready for dynamic adjustments such as tax, discount, and fixed fees
- Extensible for future features like tiered pricing, tax rules, and promotions
---
## 📖 License
This project is licensed under the Apache-2.0 license. [LICENSE](http://www.apache.org/licenses/LICENSE-2.0.txt)
---
## 🧑 Author
Jerry Maheswara <jerrymaheswara@gmail.com>
---
## ❤️ Built with Love in Rust
This project is built with ❤️ using **Rust** — a systems programming language that is safe, fast, and concurrent. Rust is the perfect choice for building reliable and efficient applications.
---
## 👋 Contributing
Pull requests, issues, and feedback are welcome!
If you find this crate useful, give it a ⭐ and share it with others in the Rust community.
---