Expand description
§Bangla (বাংলা)
A comprehensive Rust crate for handling Bangladeshi and Bengali-specific utilities.
§Features
- Bangla Date & Calendar: Convert Gregorian dates to accurate Bangla dates (following the 2019 Bangladesh Government calendar revision), generate monthly calendars, and query seasons/weekdays.
- Number & Currency Conversion: Convert ASCII digits to Bengali digits and format numbers into Bangladeshi currency (Taka) using the South Asian numbering system (Lakh/Crore grouping).
- Bangladeshi Addresses: A powerful address builder mapping divisions, districts, upazilas, unions, etc. Includes embedded BBS geo-codes, Bengali nomenclature, and JSON serialization support.
§Installation
Add this to your Cargo.toml:
[dependencies]
bangla = "0.1.0"Note: This crate relies on serde, chrono, and thiserror.
§Usage
§1. Bangla Date Conversion
Convert Gregorian dates to Bengali dates effortlessly:
use chrono::NaiveDate;
use bangla::date::{to_bangla_date, BanglaMonth, BanglaDate};
fn main() {
// 14th April 2025 -> Pohela Boishakh 1432
let gregorian_date = NaiveDate::from_ymd_opt(2025, 4, 14).unwrap();
let bangla_date: BanglaDate = to_bangla_date(gregorian_date).unwrap();
println!("Date: {}", bangla_date.formatted_bn); // Output: ১ বৈশাখ ১৪৩২
println!("Season: {}", bangla_date.season.name_bn); // Output: গ্রীষ্ম (Summer)
println!("Leap Year: {}", bangla_date.is_leap_year);
}§2. Month Calendar Generation
Generate the full 31 or 30 days of a specific Bengali month (automatically handles leap years!):
use bangla::date::{bangla_month_calendar, BanglaMonth};
fn main() {
// Generate all days for Falgun 1430 (Leap Year, so it will have 30 days)
let falgun_days = bangla_month_calendar(1430, BanglaMonth::Falgun).unwrap();
assert_eq!(falgun_days.len(), 30);
assert_eq!(falgun_days[29].day_bn, "৩০");
assert_eq!(falgun_days[29].formatted_bn, "৩০ ফাল্গুন ১৪৩০");
}§3. Number & Currency Formatting
Convert and format numerical values into Bengali text and currency formats:
use bangla::number::{to_bangla_digits, from_bangla_digits, format_taka, to_bangla_currency};
fn main() {
// Convert to Bangla digits
let en_to_bn = to_bangla_digits(1234);
assert_eq!(en_to_bn, "১২৩৪");
// Parse back to ASCII digits
let bn_to_en = from_bangla_digits("১২৩৪.৫৬");
assert_eq!(bn_to_en, "1234.56");
// Format large numbers using South Asian grouping (Lakh, Crore)
let grouped = to_bangla_currency(1_23_45_678);
assert_eq!(grouped, "১,২৩,৪৫,৬৭৮");
// Format directly to Taka
let taka = format_taka(500);
assert_eq!(taka, "৫০০ টাকা");
}§4. Bangladeshi Address Builder
Create valid Bangladeshi addresses using exact geo-codes and Bengali strings mapping natively to a JSON structure:
use bangla::address::BanglaAddress;
fn main() {
// division code: "3" (Dhaka), district code: "10" (Dhaka)
let address = BanglaAddress::new("3", "10")
// Automatically validates and finds geoCode from compiled upazila list!
.with_upazila("মিরপুর")
.with_union("পল্লবী")
.with_area("সেকশন-১১")
.with_postal_code("১২১৬");
// Generate a formatted Bengali address string
let full_address = address.format();
println!("{}", full_address);
// Output: সেকশন-১১, পল্লবী, মিরপুর, ঢাকা, ঢাকা, ১২১৬, বাংলাদেশ
// Serializes natively into JSON
let json = address.to_json();
println!("{}", json);
/*
Outputs struct aligned perfectly with your frontend JSON mapping:
{
"division": {
"geoCode": "3",
"name": "ঢাকা"
},
"district": {
"geoCode": "10",
"name": "ঢাকা"
},
"upazila": {
"geoCode": "01", // (Automatically found!)
"name": "মিরপুর"
},
"union": {
"geoCode": "01",
"name": "পল্লবী"
},
"area": "সেকশন-১১",
"postal_code": "১২১৬"
}
*/
}§Contributing
Contributions are always welcome! If you find any issues or have feature requests, please open an issue or submit a pull request on the GitHub repository.
§License
MIT License