Getting Started#

pip install bornomala-py

uv add bornomala-py

poetry add bornomala-py

from bornomala import num_to_words, words_to_num

num_to_words(0)        # 'শূন্য'
num_to_words(42)       # 'বিয়াল্লিশ'
num_to_words(1234)     # 'এক হাজার দুইশত চৌত্রিশ'
num_to_words(-7)       # 'ঋণাত্মক সাত'
num_to_words("3.14")   # 'তিন দশমিক এক চার'
num_to_words("১২৩")    # 'একশত তেইশ'   ← Bangla digit string accepted

words_to_num("এক হাজার দুইশত চৌত্রিশ")  # 1234
words_to_num("তিন দশমিক এক চার")        # 3.14

from bornomala import to_bangla_digits, to_western_digits

to_bangla_digits(2026)      # '২০২৬'
to_bangla_digits(-3.14)     # '-৩.১৪'
to_western_digits("২০২৬")  # '2026'

from bornomala import to_bangla_ordinal

to_bangla_ordinal(1)    # '১ম'
to_bangla_ordinal(4)    # '৪র্থ'
to_bangla_ordinal(6)    # '৬ষ্ঠ'
to_bangla_ordinal(11)   # '১১তম'

from bornomala import format_currency

format_currency(500)          # 'পাঁচশত টাকা মাত্র'
format_currency("1234.50")    # 'এক হাজার দুইশত চৌত্রিশ টাকা পঞ্চাশ পয়সা মাত্র'

from bornomala import BanglaDate, BanglaDatetime

bd = BanglaDate(2026, 3, 12)
str(bd)                           # '১২ মার্চ ২০২৬'
bd.strftime("%A, %e %B %Y")       # 'বৃহস্পতিবার, ১২ মার্চ ২০২৬'

bdt = BanglaDatetime(2026, 3, 12, 10, 30)
str(bdt)                          # 'বৃহস্পতিবার, ১২ মার্চ ২০২৬, ১০:৩০'

from bornomala import gregorian_to_bangla
from datetime import date

bd = gregorian_to_bangla(date(2026, 3, 12))
str(bd)       # '২৮ ফাল্গুন ১৪৩২'
bd.season     # 'বসন্ত'

from bornomala import normalize, is_bangla, is_pure_bangla, bangla_char_count

normalize("আমার  সোনার  বাংলা")   # 'আমার সোনার বাংলা'
normalize("এক|দুই")              # 'এক।দুই'  (pipe → daari)
is_bangla("hello আমি")           # True
is_pure_bangla("আমার বাংলা।")    # True
bangla_char_count("hello আমি")   # 3