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
134
135
136
137
138
139
140
141
142
143
144
145
146
//! # 🧮 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!("Adjustment 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.
//!
//! ---
/// Core data model definitions for pricing operations.
pub use dec;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;