worldmoneywords 2.5.0__tar.gz

worldmoneywords-2.5.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: worldmoneywords
+Version: 2.5.0
+Summary: Convert monetary amounts to English, Hindi, or Arabic words using ISO country and currency codes
+Author: Md Ikram
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/3mdikram/WorldMoneyWords
+Project-URL: Repository, https://github.com/3mdikram/WorldMoneyWords
+Project-URL: Issues, https://github.com/3mdikram/WorldMoneyWords/issues
+Keywords: amount,currency,money,numbers,words,iso-3166,iso-4217
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# WorldMoneyWords for Python
+
+```bash
+pip install worldmoneywords
+```
+
+```python
+from amount_to_words import AmountToWords
+
+converter = AmountToWords()
+print(converter.convert("1234.50", "IN", "INR"))
+```
+
+An optional fourth `ConversionOptions` argument controls the suffix, zero minor units, conjunction, short currency names, and output `language` (`en`, `hi`, `ar`, or a registered language code). Set `short_currency_name=True` to output `Dollars` instead of `US Dollars`.
+
+```python
+converter.convert("1234.50", "IN", "INR", ConversionOptions(language="hi"))
+converter.convert("1234.50", "US", "USD", ConversionOptions(language="ar"))
+```
+
+The arguments are amount, ISO 3166-1 Alpha-2 or Alpha-3 country code, and ISO 4217 currency code.

worldmoneywords-2.5.0/README.md

@@ -0,0 +1,21 @@
+# WorldMoneyWords for Python
+
+```bash
+pip install worldmoneywords
+```
+
+```python
+from amount_to_words import AmountToWords
+
+converter = AmountToWords()
+print(converter.convert("1234.50", "IN", "INR"))
+```
+
+An optional fourth `ConversionOptions` argument controls the suffix, zero minor units, conjunction, short currency names, and output `language` (`en`, `hi`, `ar`, or a registered language code). Set `short_currency_name=True` to output `Dollars` instead of `US Dollars`.
+
+```python
+converter.convert("1234.50", "IN", "INR", ConversionOptions(language="hi"))
+converter.convert("1234.50", "US", "USD", ConversionOptions(language="ar"))
+```
+
+The arguments are amount, ISO 3166-1 Alpha-2 or Alpha-3 country code, and ISO 4217 currency code.

worldmoneywords-2.5.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "worldmoneywords"
+version = "2.5.0"
+description = "Convert monetary amounts to English, Hindi, or Arabic words using ISO country and currency codes"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  {name = "Md Ikram"}
+]
+keywords = ["amount", "currency", "money", "numbers", "words", "iso-3166", "iso-4217"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[project.urls]
+Homepage = "https://github.com/3mdikram/WorldMoneyWords"
+Repository = "https://github.com/3mdikram/WorldMoneyWords"
+Issues = "https://github.com/3mdikram/WorldMoneyWords/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

worldmoneywords-2.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

worldmoneywords-2.5.0/src/amount_to_words/__init__.py

@@ -0,0 +1,3 @@
+from .converter import AmountToWords, ConversionOptions, Currency, LanguagePack
+
+__all__ = ["AmountToWords", "ConversionOptions", "Currency", "LanguagePack"]

worldmoneywords-2.5.0/src/amount_to_words/converter.py

@@ -0,0 +1,185 @@
+from dataclasses import dataclass
+from decimal import Decimal, InvalidOperation, ROUND_HALF_UP
+import re
+from typing import Callable
+from .countries import ISO_COUNTRY_CODES
+
+ONES = ["Zero", "One", "Two", "Three", "Four", "Five", "Six", "Seven", "Eight", "Nine", "Ten", "Eleven", "Twelve", "Thirteen", "Fourteen", "Fifteen", "Sixteen", "Seventeen", "Eighteen", "Nineteen"]
+TENS = ["", "", "Twenty", "Thirty", "Forty", "Fifty", "Sixty", "Seventy", "Eighty", "Ninety"]
+SCALES = ["", "Thousand", "Million", "Billion", "Trillion", "Quadrillion"]
+
+@dataclass(frozen=True)
+class Currency:
+    major_singular: str
+    major_plural: str
+    minor_singular: str
+    minor_plural: str
+    fraction_digits: int = 2
+
+@dataclass(frozen=True)
+class ConversionOptions:
+    include_only: bool = True
+    include_zero_minor: bool = False
+    conjunction: str = "and"
+    language: str = "en"
+    short_currency_name: bool = False
+
+    def __post_init__(self):
+        if not self.conjunction.strip():
+            raise ValueError("Conjunction cannot be empty")
+        if not self.language.strip():
+            raise ValueError("Language cannot be empty")
+
+@dataclass(frozen=True)
+class LanguagePack:
+    code: str
+    spell: Callable[[int], str]
+    currency_name: Callable[[str, bool], str]
+    minus: str
+    conjunction: str
+    only: str
+    minor_singular: str
+    minor_plural: str
+
+    def __post_init__(self):
+        normalized = self.code.strip().lower()
+        if not re.fullmatch(r"[a-z]{2,8}(?:-[a-z0-9]{2,8})*", normalized):
+            raise ValueError("Language pack code must be a valid language tag")
+        for value in (self.minus, self.conjunction, self.only, self.minor_singular, self.minor_plural):
+            if not value.strip(): raise ValueError("Language pack labels cannot be empty")
+        object.__setattr__(self, "code", normalized)
+
+CURRENCIES = {
+    "INR": Currency("Rupee", "Rupees", "Paisa", "Paise"),
+    "USD": Currency("US Dollar", "US Dollars", "Cent", "Cents"),
+    "GBP": Currency("Pound", "Pounds", "Penny", "Pence"),
+    "EUR": Currency("Euro", "Euros", "Cent", "Cents"),
+    "AED": Currency("Dirham", "Dirhams", "Fil", "Fils"),
+    "JPY": Currency("Yen", "Yen", "", "", 0),
+}
+
+def _under_thousand(value: int) -> str:
+    words = []
+    if value >= 100:
+        words += [ONES[value // 100], "Hundred"]
+        value %= 100
+    if value >= 20:
+        words.append(TENS[value // 10])
+        if value % 10:
+            words.append(ONES[value % 10])
+    elif value:
+        words.append(ONES[value])
+    return " ".join(words)
+
+def _spell(value: int) -> str:
+    if value == 0:
+        return "Zero"
+    chunks = []
+    scale = 0
+    while value:
+        chunk = value % 1000
+        if chunk:
+            part = _under_thousand(chunk)
+            if SCALES[scale]:
+                part += " " + SCALES[scale]
+            chunks.append(part)
+        value //= 1000
+        scale += 1
+        if scale >= len(SCALES) and value:
+            raise ValueError("Amount is outside the supported range")
+    return " ".join(reversed(chunks))
+
+HI_0_99 = "शून्य|एक|दो|तीन|चार|पाँच|छह|सात|आठ|नौ|दस|ग्यारह|बारह|तेरह|चौदह|पन्द्रह|सोलह|सत्रह|अठारह|उन्नीस|बीस|इक्कीस|बाईस|तेईस|चौबीस|पच्चीस|छब्बीस|सत्ताईस|अट्ठाईस|उनतीस|तीस|इकतीस|बत्तीस|तैंतीस|चौंतीस|पैंतीस|छत्तीस|सैंतीस|अड़तीस|उनतालीस|चालीस|इकतालीस|बयालीस|तैंतालीस|चौवालीस|पैंतालीस|छियालीस|सैंतालीस|अड़तालीस|उनचास|पचास|इक्यावन|बावन|तिरेपन|चौवन|पचपन|छप्पन|सत्तावन|अट्ठावन|उनसठ|साठ|इकसठ|बासठ|तिरेसठ|चौंसठ|पैंसठ|छियासठ|सड़सठ|अड़सठ|उनहत्तर|सत्तर|इकहत्तर|बहत्तर|तिहत्तर|चौहत्तर|पचहत्तर|छिहत्तर|सतहत्तर|अठहत्तर|उनासी|अस्सी|इक्यासी|बयासी|तिरासी|चौरासी|पचासी|छियासी|सत्तासी|अट्ठासी|नवासी|नब्बे|इक्यानबे|बानबे|तिरानबे|चौरानबे|पंचानबे|छियानबे|सत्तानबे|अट्ठानबे|निन्यानबे".split("|")
+AR_0_19 = "صفر|واحد|اثنان|ثلاثة|أربعة|خمسة|ستة|سبعة|ثمانية|تسعة|عشرة|أحد عشر|اثنا عشر|ثلاثة عشر|أربعة عشر|خمسة عشر|ستة عشر|سبعة عشر|ثمانية عشر|تسعة عشر".split("|")
+AR_TENS = ["", "", "عشرون", "ثلاثون", "أربعون", "خمسون", "ستون", "سبعون", "ثمانون", "تسعون"]
+
+def _under_100_localized(value: int, language: str) -> str:
+    if language == "hi": return HI_0_99[value]
+    if value < 20: return AR_0_19[value]
+    return AR_TENS[value // 10] if value % 10 == 0 else f"{AR_0_19[value % 10]} و{AR_TENS[value // 10]}"
+
+def _under_1000_localized(value: int, language: str) -> str:
+    parts = []
+    if value >= 100:
+        hundreds = value // 100
+        if language == "hi": parts.append(("एक" if hundreds == 1 else HI_0_99[hundreds]) + " सौ")
+        else: parts.append({1:"مائة",2:"مائتان"}.get(hundreds, AR_0_19[hundreds] + " مائة"))
+        value %= 100
+    if value: parts.append(_under_100_localized(value, language))
+    return (" و" if language == "ar" else " ").join(parts)
+
+def _spell_localized(value: int, language: str) -> str:
+    if language == "en": return _spell(value)
+    if value == 0: return HI_0_99[0] if language == "hi" else AR_0_19[0]
+    scales = ["", "हज़ार", "मिलियन", "बिलियन", "ट्रिलियन", "क्वाड्रिलियन"] if language == "hi" else ["", "ألف", "مليون", "مليار", "تريليون", "كوادريليون"]
+    chunks, scale = [], 0
+    while value:
+        chunk = value % 1000
+        if chunk:
+            part = "" if language == "ar" and chunk == 1 and scale > 0 else _under_1000_localized(chunk, language)
+            if scales[scale]: part = (part + " " if part else "") + scales[scale]
+            chunks.append(part)
+        value //= 1000; scale += 1
+        if scale >= len(scales) and value: raise ValueError("Amount is outside the supported range")
+    return (" و" if language == "ar" else " ").join(reversed(chunks))
+
+LOCALIZED_CURRENCIES = {
+    "hi": {"INR":"भारतीय रुपया", "USD":"अमेरिकी डॉलर", "GBP":"ब्रिटिश पाउंड", "EUR":"यूरो", "AED":"यूएई दिरहम", "JPY":"जापानी येन"},
+    "ar": {"INR":"روبية هندية", "USD":"دولار أمريكي", "GBP":"جنيه إسترليني", "EUR":"يورو", "AED":"درهم إماراتي", "JPY":"ين ياباني"},
+}
+SHORT_CURRENCIES = {
+    "en": {"INR":("Rupee","Rupees"), "USD":("Dollar","Dollars"), "GBP":("Pound","Pounds"), "EUR":("Euro","Euros"), "AED":("Dirham","Dirhams"), "JPY":("Yen","Yen")},
+    "hi": {"INR":("रुपया","रुपये"), "USD":("डॉलर","डॉलर"), "GBP":("पाउंड","पाउंड"), "EUR":("यूरो","यूरो"), "AED":("दिरहम","दिरहम"), "JPY":("येन","येन")},
+    "ar": {"INR":("روبية","روبية"), "USD":("دولار","دولار"), "GBP":("جنيه","جنيه"), "EUR":("يورو","يورو"), "AED":("درهم","درهم"), "JPY":("ين","ين")},
+}
+
+class AmountToWords:
+    def __init__(self, currencies: dict[str, Currency] | None = None, language_packs: list[LanguagePack] | None = None):
+        self.currencies = {**CURRENCIES, **(currencies or {})}
+        self.language_packs = {pack.code: pack for pack in (language_packs or [])}
+
+    def add_language_pack(self, pack: LanguagePack) -> "AmountToWords":
+        return AmountToWords(self.currencies, [*self.language_packs.values(), pack])
+
+    def convert(self, amount: int | float | str | Decimal, country_code: str, currency_code: str, options: ConversionOptions | None = None) -> str:
+        options = options or ConversionOptions()
+        country_input = country_code.strip().upper()
+        country = ISO_COUNTRY_CODES.get(country_input)
+        code = currency_code.strip().upper()
+        if country is None:
+            raise ValueError("Unknown ISO 3166-1 Alpha-2 or Alpha-3 country code")
+        language = _resolve_language(options.language, self.language_packs)
+        pack = self.language_packs.get(language)
+        if not re.fullmatch(r"[A-Z]{3}", code):
+            raise ValueError("Currency code must be a three-letter ISO 4217 code")
+        currency = self.currencies.get(code, Currency(code, code, "Minor Unit", "Minor Units"))
+        try:
+            value = Decimal(str(amount))
+        except InvalidOperation as error:
+            raise ValueError("Amount must be numeric") from error
+        quantum = Decimal(1).scaleb(-currency.fraction_digits)
+        value = value.quantize(quantum, rounding=ROUND_HALF_UP)
+        negative = value < 0
+        value = abs(value)
+        major = int(value)
+        minor = int((value - major) * (10 ** currency.fraction_digits))
+        labels = (pack.minus, pack.conjunction, pack.only, pack.minor_singular, pack.minor_plural) if pack else {"en": ("Minus", "and", "Only", "Minor Unit", "Minor Units"), "hi": ("ऋण", "और", "मात्र", "उप-इकाई", "उप-इकाइयाँ"), "ar": ("سالب", "و", "فقط", "وحدة فرعية", "وحدات فرعية")}[language]
+        parts = [labels[0]] if negative else []
+        major_name = currency.major_singular if major == 1 else currency.major_plural
+        if pack: major_name = pack.currency_name(code, major == 1)
+        elif language != "en": major_name = LOCALIZED_CURRENCIES[language].get(code, code)
+        if options.short_currency_name: major_name = SHORT_CURRENCIES.get(language, {}).get(code, (major_name, major_name))[0 if major == 1 else 1]
+        parts += [pack.spell(major) if pack else _spell_localized(major, language), major_name]
+        if minor or (currency.fraction_digits > 0 and options.include_zero_minor):
+            conjunction = labels[1] if options.conjunction == "and" else options.conjunction
+            minor_name = currency.minor_singular if minor == 1 else currency.minor_plural
+            if language != "en": minor_name = labels[3] if minor == 1 else labels[4]
+            parts += [conjunction, pack.spell(minor) if pack else _spell_localized(minor, language), minor_name]
+        if options.include_only:
+            parts.append(labels[2])
+        return " ".join(filter(None, parts))
+
+def _resolve_language(requested: str, language_packs: dict[str, LanguagePack] | None = None) -> str:
+    language = requested.strip().lower()
+    if language in {"en", "hi", "ar"} or language in (language_packs or {}): return language
+    return "en"

worldmoneywords-2.5.0/src/amount_to_words/countries.py

@@ -0,0 +1,2 @@
+ALPHA2_TO_ALPHA3 = dict(pair.split(":") for pair in "AF:AFG AO:AGO AL:ALB AD:AND AE:ARE AR:ARG AM:ARM AG:ATG AU:AUS AT:AUT AZ:AZE BI:BDI BE:BEL BJ:BEN BF:BFA BD:BGD BG:BGR BH:BHR BS:BHS BA:BIH BY:BLR BZ:BLZ BO:BOL BR:BRA BB:BRB BN:BRN BT:BTN BW:BWA CF:CAF CA:CAN CH:CHE CL:CHL CN:CHN CI:CIV CM:CMR CD:COD CG:COG CO:COL KM:COM CV:CPV CR:CRI CU:CUB CY:CYP CZ:CZE DE:DEU DJ:DJI DM:DMA DK:DNK DO:DOM DZ:DZA EC:ECU EG:EGY ER:ERI EH:ESH ES:ESP EE:EST ET:ETH FI:FIN FJ:FJI FR:FRA FM:FSM GA:GAB GB:GBR GE:GEO GH:GHA GN:GIN GM:GMB GW:GNB GQ:GNQ GR:GRC GD:GRD GT:GTM GY:GUY HK:HKG HN:HND HR:HRV HT:HTI HU:HUN ID:IDN IN:IND IE:IRL IR:IRN IQ:IRQ IS:ISL IL:ISR IT:ITA JM:JAM JO:JOR JP:JPN KZ:KAZ KE:KEN KG:KGZ KH:KHM KI:KIR KN:KNA KR:KOR KW:KWT LA:LAO LB:LBN LR:LBR LY:LBY LC:LCA LI:LIE LK:LKA LS:LSO LT:LTU LU:LUX LV:LVA MO:MAC MA:MAR MC:MCO MD:MDA MG:MDG MV:MDV MX:MEX MH:MHL MK:MKD ML:MLI MT:MLT MM:MMR ME:MNE MN:MNG MZ:MOZ MR:MRT MU:MUS MW:MWI MY:MYS NA:NAM NE:NER NG:NGA NI:NIC NL:NLD NO:NOR NP:NPL NR:NRU NZ:NZL OM:OMN PK:PAK PA:PAN PE:PER PH:PHL PW:PLW PG:PNG PL:POL KP:PRK PT:PRT PY:PRY PS:PSE QA:QAT RO:ROU RU:RUS RW:RWA SA:SAU SD:SDN SN:SEN SG:SGP SB:SLB SL:SLE SV:SLV SM:SMR SO:SOM RS:SRB SS:SSD ST:STP SR:SUR SK:SVK SI:SVN SE:SWE SZ:SWZ SC:SYC SY:SYR TD:TCD TG:TGO TH:THA TJ:TJK TM:TKM TL:TLS TO:TON TT:TTO TN:TUN TR:TUR TV:TUV TW:TWN TZ:TZA UG:UGA UA:UKR UY:URY US:USA UZ:UZB VA:VAT VC:VCT VE:VEN VN:VNM VU:VUT WS:WSM XK:XKX YE:YEM ZA:ZAF ZM:ZMB ZW:ZWE".split())
+ISO_COUNTRY_CODES = {**{code: code for code in ALPHA2_TO_ALPHA3.values()}, **ALPHA2_TO_ALPHA3}

worldmoneywords-2.5.0/src/worldmoneywords.egg-info/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: worldmoneywords
+Version: 2.5.0
+Summary: Convert monetary amounts to English, Hindi, or Arabic words using ISO country and currency codes
+Author: Md Ikram
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/3mdikram/WorldMoneyWords
+Project-URL: Repository, https://github.com/3mdikram/WorldMoneyWords
+Project-URL: Issues, https://github.com/3mdikram/WorldMoneyWords/issues
+Keywords: amount,currency,money,numbers,words,iso-3166,iso-4217
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# WorldMoneyWords for Python
+
+```bash
+pip install worldmoneywords
+```
+
+```python
+from amount_to_words import AmountToWords
+
+converter = AmountToWords()
+print(converter.convert("1234.50", "IN", "INR"))
+```
+
+An optional fourth `ConversionOptions` argument controls the suffix, zero minor units, conjunction, short currency names, and output `language` (`en`, `hi`, `ar`, or a registered language code). Set `short_currency_name=True` to output `Dollars` instead of `US Dollars`.
+
+```python
+converter.convert("1234.50", "IN", "INR", ConversionOptions(language="hi"))
+converter.convert("1234.50", "US", "USD", ConversionOptions(language="ar"))
+```
+
+The arguments are amount, ISO 3166-1 Alpha-2 or Alpha-3 country code, and ISO 4217 currency code.

worldmoneywords-2.5.0/src/worldmoneywords.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/amount_to_words/__init__.py
+src/amount_to_words/converter.py
+src/amount_to_words/countries.py
+src/worldmoneywords.egg-info/PKG-INFO
+src/worldmoneywords.egg-info/SOURCES.txt
+src/worldmoneywords.egg-info/dependency_links.txt
+src/worldmoneywords.egg-info/top_level.txt
+tests/test_converter.py

worldmoneywords-2.5.0/src/worldmoneywords.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

worldmoneywords-2.5.0/src/worldmoneywords.egg-info/top_level.txt

@@ -0,0 +1 @@
+amount_to_words

worldmoneywords-2.5.0/tests/test_converter.py

@@ -0,0 +1,48 @@
+import unittest
+from amount_to_words import AmountToWords, ConversionOptions, LanguagePack
+from amount_to_words.countries import ALPHA2_TO_ALPHA3
+
+class ConverterTest(unittest.TestCase):
+    def test_custom_official_language_pack(self):
+        pack = LanguagePack("xx", lambda number: f"number-{number}", lambda code, singular: code.lower() + ("-unit" if singular else "-units"), "negative", "with", "complete", "part", "parts")
+        converter = AmountToWords().add_language_pack(pack)
+        self.assertEqual("number-2 usd-units with number-50 parts complete", converter.convert("2.50", "US", "USD", ConversionOptions(language="xx")))
+
+    def test_inr(self):
+        self.assertEqual("One Thousand Two Hundred Thirty Four Rupees and Fifty Paise Only", AmountToWords().convert("1234.50", "IND", "INR"))
+
+    def test_negative_gbp(self):
+        self.assertEqual("Minus Ten Pounds and Twenty Five Pence Only", AmountToWords().convert("-10.25", "GBR", "GBP"))
+
+    def test_alpha2_country(self):
+        self.assertEqual("Ten Rupees Only", AmountToWords().convert("10", "IN", "INR"))
+
+    def test_minor_territory_is_not_supported(self):
+        with self.assertRaises(ValueError):
+            AmountToWords().convert("10", "AI", "USD")
+
+    def test_options(self):
+        options = ConversionOptions(include_only=False, include_zero_minor=True, conjunction="plus")
+        self.assertEqual("Ten US Dollars plus Zero Cents", AmountToWords().convert("10", "US", "USD", options))
+
+    def test_short_currency_name_option(self):
+        options = ConversionOptions(include_only=False, include_zero_minor=True, conjunction="plus", short_currency_name=True)
+        self.assertEqual("Ten Dollars plus Zero Cents", AmountToWords().convert("10", "US", "USD", options))
+
+    def test_hindi_and_arabic(self):
+        self.assertEqual("एक हज़ार दो सौ चौंतीस भारतीय रुपया और पचास उप-इकाइयाँ मात्र", AmountToWords().convert("1234.50", "IN", "INR", ConversionOptions(language="hi")))
+        self.assertEqual("ألف ومائتان وأربعة وثلاثون دولار أمريكي و خمسون وحدات فرعية فقط", AmountToWords().convert("1234.50", "US", "USD", ConversionOptions(language="ar")))
+
+    def test_all_languages_work_for_all_200_countries(self):
+        self.assertEqual(200, len(ALPHA2_TO_ALPHA3))
+        converter = AmountToWords()
+        for country in ALPHA2_TO_ALPHA3:
+            for language in ("en", "hi", "ar"):
+                self.assertTrue(converter.convert("42.50", country, "USD", ConversionOptions(language=language)))
+
+    def test_unavailable_language_falls_back_to_english(self):
+        converter = AmountToWords()
+        self.assertTrue(converter.convert("10", "PK", "PKR", ConversionOptions(language="ur")).startswith("Ten"))
+
+if __name__ == "__main__":
+    unittest.main()