bangla 0.1.1

A Rust crate for Bangla date, calendar, number conversion, currency, and Bangladeshi addresses.
Documentation

Bangla (বাংলা)

CI Crates.io Documentation License: MIT

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