pricing_kit 0.1.2

A flexible, lightweight Rust library for pricing strategies, including calculating and managing prices, markup, commissions, and multi-currency support.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

//! # 🧮 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
//! - 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, PricingDetail, MarkupType};
//!
//! 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, 1.0);
//!     converter.add_exchange_rate(&idr, 16500.0);
//!
//!     let mut pricing = PricingDetail::new(100.0, usd.clone(), idr.clone());
//!     pricing.set_markup(MarkupType::Amount {
//!         value: 3500.0,
//!         currency: idr.clone(),
//!     });
//!
//!     pricing.apply_markup(&converter);
//!
//!     let json = serde_json::to_string_pretty(&pricing)?;
//!     println!("Pricing:\n{}", json);
//!
//!     Ok(())
//! }
//! ```
//! 
//! ## ⚡ Adjustment feature example
//! 
//! ```rust
//! use pricing_kit::{Currency, CurrencyConverter, PricingDetail, MarkupType};
//! use pricing_kit::PriceAdjustment;
//! 
//! 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, 1.0);
//!     converter.add_exchange_rate(&idr, 16500.0);
//! 
//!     let mut pricing = PricingDetail::new(100.0, usd.clone(), idr.clone());
//!     pricing.set_markup(MarkupType::Percentage(20.0));
//!     pricing.apply_markup(&converter);
//! 
//!     let adjustments = vec![
//!         PriceAdjustment::Tax {
//!             name: "Tax 11%".into(),
//!             percentage: 11.0,
//!         },
//!         PriceAdjustment::Discount {
//!             name: "Discount".into(),
//!             percentage: 5.0,
//!         },
//!         PriceAdjustment::Fixed {
//!             name: "Promo New Year".to_string(),
//!             amount: 10.0,
//!             currency: pricing.sell_currency.clone(),
//!         }
//!     ];
//! 
//!     pricing.apply_adjustments(&adjustments, &converter);
//! 
//!     let json = serde_json::to_string_pretty(&pricing)?;
//!     println!("==================\nAdjustment Pricing:\n{}", json);
//! 
//!     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
//! - 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.
//!
//! ---


/// Core data model definitions for pricing operations.
pub mod model;

pub use model::currency::Currency;
pub use model::currency::CurrencyConverter;
pub use model::pricing::PricingDetail;
pub use model::markup::MarkupType;
pub use model::adjustment::PriceAdjustment;