persiantools 4.2.0__tar.gz → 5.1.0__tar.gz

{persiantools-4.2.0/persiantools.egg-info → persiantools-5.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: persiantools
-Version: 4.2.0
+Version: 5.1.0
 Summary: Jalali date and datetime with other tools
 Home-page: https://github.com/majiidd/persiantools
 Author: Majid Hajiloo
@@ -13,11 +13,11 @@ Classifier: Natural Language :: Persian
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development
@@ -25,7 +25,7 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Localization
 Classifier: Topic :: Utilities
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pytz
@@ -39,70 +39,78 @@ Requires-Dist: pytz
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/persiantools.svg)](https://pypi.org/project/persiantools/)
 [![PyPI - License](https://img.shields.io/pypi/l/persiantools.svg)](https://pypi.org/project/persiantools/)
 
-Provides Jalali (also known as Shamsi or Persian) dates and datetimes functionalities, among other tools.
-- It converts between Jalali and Gregorian dates and datetimes (based on python datetime's module).
-- It supports operators like `+`, `-`, `==`, and `>=`.
-- It includes timezone support.
-- It converts between Arabic and Persian characters/digits.
-- It turns numbers into Persian words.
+PersianTools provides comprehensive tools for handling Jalali (Shamsi or Persian) dates, date-time functionalities, and more.
+- Conversion between Jalali and Gregorian dates/datetimes using Python's native datetime module.
+- Full support for operations like `+`, `-`, `==`, and `>=`.
+- Timezone-aware date and datetime handling.
+- Conversion between Persian and Arabic characters and digits.
+- Conversion of numbers to their Persian word representation.
 
 ## Install Package
 You can install the package using pip with the following command:
 ```bash
 python -m pip install persiantools
 ```
-Persiantools supports Python 3.8+. (_for python 2.7 and 3.5 use [1.5.x](https://github.com/majiidd/persiantools/tree/1.5.x) version_)
 
-## How to use
+## Usage Guide
 
-### Date
+### Date Operations
 
 ```python
 >>> from persiantools.jdatetime import JalaliDate
 >>> import datetime
 
+# Get today's date in Jalali
 >>> JalaliDate.today()
-JalaliDate(1395, 4, 18, Jomeh)
+JalaliDate(1403, 8, 18, Jomeh)
 
->>> JalaliDate(1369, 7, 1)
-JalaliDate(1369, 7, 1, Yekshanbeh)
+>>> JalaliDate(1367, 2, 14)
+JalaliDate(1367, 2, 14, Chaharshanbeh)
 
->>> JalaliDate(datetime.date(1990, 9, 23))      # Gregorian to Jalali
-JalaliDate(1369, 7, 1, Yekshanbeh)
+# Convert Gregorian to Jalali
+>>> JalaliDate(datetime.date(1988, 5, 4))
+JalaliDate(1367, 2, 14, Chaharshanbeh)
 
->>> JalaliDate.to_jalali(2013, 9, 16)           # Gregorian to Jalali
+# Convert from Gregorian to Jalali using method
+>>> JalaliDate.to_jalali(2013, 9, 16)
 JalaliDate(1392, 6, 25, Doshanbeh)
 
->>> JalaliDate(1392, 6, 25).to_gregorian()      # Jalali to Gregorian
+# Convert from Jalali to Gregorian
+>>> JalaliDate(1392, 6, 25).to_gregorian()
 datetime.date(2013, 9, 16)
 
->>> JalaliDate.fromtimestamp(578707200)         # Timestamp to Jalali
+# Create a Jalali date from a Unix timestamp
+>>> JalaliDate.fromtimestamp(578707200)
 JalaliDate(1367, 2, 14, Chaharshanbeh)
 ```
 
-### Datetime
+### Datetime Operations
 
 ```python
 >>> from persiantools.jdatetime import JalaliDateTime
 >>> import datetime, pytz
 
+# Get the current Jalali datetime
 >>> JalaliDateTime.now()
-JalaliDateTime(1395, 4, 18, 1, 43, 24, 720505)
+JalaliDateTime(1403, 8, 18, 12, 48, 54, 569082)
 
->>> JalaliDateTime.now().to_gregorian()                                     # Jalali to Gregorian
-datetime.datetime(2016, 7, 8, 1, 43, 24, 720505)
+# Convert Jalali datetime to Gregorian
+>>> JalaliDateTime.now().to_gregorian()
+datetime.datetime(2024, 11, 8, 12, 48, 54, 569082)
 
->>> JalaliDateTime.to_jalali(datetime.datetime(1988, 5, 4, 14, 0, 0, 0))    # Gregorian to Jalali
+# Convert Gregorian datetime to Jalali
+>>> JalaliDateTime.to_jalali(datetime.datetime(1988, 5, 4, 14, 0, 0, 0))
 JalaliDateTime(1367, 2, 14, 14, 0)
 
->>> JalaliDateTime.fromtimestamp(578723400, pytz.timezone("Asia/Tehran"))   # Timestamp to Jalali
+# Create a timezone-aware Jalali datetime from a timestamp
+>>> JalaliDateTime.fromtimestamp(578723400, pytz.timezone("Asia/Tehran"))
 JalaliDateTime(1367, 2, 14, 8, 0, tzinfo=<DstTzInfo 'Asia/Tehran' +0330+3:30:00 STD>)
 
 >>> JalaliDateTime.now(pytz.utc)
 JalaliDateTime(1395, 4, 17, 21, 23, 53, 474618, tzinfo=<UTC>)
 ```
 
-### Format
+### Formatting
 
 Based on python `strftime()` behavior
 
@@ -110,39 +118,44 @@ Based on python `strftime()` behavior
 >>> from persiantools.jdatetime import JalaliDate, JalaliDateTime
 >>> import pytz
 
+# ISO formatting
 >>> JalaliDate(1367, 2, 14).isoformat()
 '1367-02-14'
 
+# Custom date formatting
 >>> JalaliDate(1395, 3, 1).strftime("%Y/%m/%d")
 '1395/03/01'
 
+# Custom datetime formatting
 >>> JalaliDateTime(1369, 7, 1, 14, 0, 10, 0, pytz.utc).strftime("%c")
 'Yekshanbeh 01 Mehr 1369 14:00:10'
-
->>> JalaliDateTime.now(pytz.utc).strftime("%I:%M:%S.%f %p %z %Z")
-'01:49:22.518523 PM +0000 UTC'
 ```
 
-### Digits/Characters Tools
+### Digits and Character Conversion
 
 ```python
 >>> from persiantools import characters, digits
 
+# Convert English digits to Persian
 >>> digits.en_to_fa("0987654321")
 '۰۹۸۷۶۵۴۳۲۱'
 
+# Convert Arabic digits to Persian
 >>> digits.ar_to_fa("٠٩٨٧٦٥٤٣٢١")
 '۰۹۸۷۶۵۴۳۲۱'
 
+# Convert Persian digits to English
 >>> digits.fa_to_en("۰۹۸۷۶۵۴۳۲۱")
 '0987654321'
 
+# Convert numbers to Persian words
 >>> digits.to_word(9512026)
 'نه میلیون و پانصد و دوازده هزار و بیست و شش'
 
 >>> digits.to_word(15.007)
 'پانزده و هفت هزارم'
 
+# Convert Arabic to Persian characters
 >>> characters.ar_to_fa("كيك")
 'کیک'
 ```
@@ -169,21 +182,19 @@ JalaliDate(1395, 3, 21, Jomeh)
 datetime.timedelta(365)
 ```
 
-### Serializing and de-serializing
+### Serializing and Deserializing
 
 ```python
 >>> from persiantools.jdatetime import JalaliDate
 >>> import pickle
 
->>> # Serializing
->>> file = open("save.p", "wb")
->>> pickle.dump(JalaliDate(1367, 2, 14), file)
->>> file.close()
+# Serialize a Jalali date to a file
+>>> with open("save.p", "wb") as file:
+>>>     pickle.dump(JalaliDate(1367, 2, 14), file)
 
->>> # de-serializing
->>> file = open("save.p", "rb")
->>> jalali = pickle.load(file)
->>> file.close()
+# Deserialize from a file
+>>> with open("save.p", "rb") as file:
+>>>     jalali = pickle.load(file)
 >>> jalali
 JalaliDate(1367, 2, 14, Chaharshanbeh)
 ```

{persiantools-4.2.0 → persiantools-5.1.0}/README.md

@@ -7,70 +7,78 @@
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/persiantools.svg)](https://pypi.org/project/persiantools/)
 [![PyPI - License](https://img.shields.io/pypi/l/persiantools.svg)](https://pypi.org/project/persiantools/)
 
-Provides Jalali (also known as Shamsi or Persian) dates and datetimes functionalities, among other tools.
-- It converts between Jalali and Gregorian dates and datetimes (based on python datetime's module).
-- It supports operators like `+`, `-`, `==`, and `>=`.
-- It includes timezone support.
-- It converts between Arabic and Persian characters/digits.
-- It turns numbers into Persian words.
+PersianTools provides comprehensive tools for handling Jalali (Shamsi or Persian) dates, date-time functionalities, and more.
+- Conversion between Jalali and Gregorian dates/datetimes using Python's native datetime module.
+- Full support for operations like `+`, `-`, `==`, and `>=`.
+- Timezone-aware date and datetime handling.
+- Conversion between Persian and Arabic characters and digits.
+- Conversion of numbers to their Persian word representation.
 
 ## Install Package
 You can install the package using pip with the following command:
 ```bash
 python -m pip install persiantools
 ```
-Persiantools supports Python 3.8+. (_for python 2.7 and 3.5 use [1.5.x](https://github.com/majiidd/persiantools/tree/1.5.x) version_)
 
-## How to use
+## Usage Guide
 
-### Date
+### Date Operations
 
 ```python
 >>> from persiantools.jdatetime import JalaliDate
 >>> import datetime
 
+# Get today's date in Jalali
 >>> JalaliDate.today()
-JalaliDate(1395, 4, 18, Jomeh)
+JalaliDate(1403, 8, 18, Jomeh)
 
->>> JalaliDate(1369, 7, 1)
-JalaliDate(1369, 7, 1, Yekshanbeh)
+>>> JalaliDate(1367, 2, 14)
+JalaliDate(1367, 2, 14, Chaharshanbeh)
 
->>> JalaliDate(datetime.date(1990, 9, 23))      # Gregorian to Jalali
-JalaliDate(1369, 7, 1, Yekshanbeh)
+# Convert Gregorian to Jalali
+>>> JalaliDate(datetime.date(1988, 5, 4))
+JalaliDate(1367, 2, 14, Chaharshanbeh)
 
->>> JalaliDate.to_jalali(2013, 9, 16)           # Gregorian to Jalali
+# Convert from Gregorian to Jalali using method
+>>> JalaliDate.to_jalali(2013, 9, 16)
 JalaliDate(1392, 6, 25, Doshanbeh)
 
->>> JalaliDate(1392, 6, 25).to_gregorian()      # Jalali to Gregorian
+# Convert from Jalali to Gregorian
+>>> JalaliDate(1392, 6, 25).to_gregorian()
 datetime.date(2013, 9, 16)
 
->>> JalaliDate.fromtimestamp(578707200)         # Timestamp to Jalali
+# Create a Jalali date from a Unix timestamp
+>>> JalaliDate.fromtimestamp(578707200)
 JalaliDate(1367, 2, 14, Chaharshanbeh)
 ```
 
-### Datetime
+### Datetime Operations
 
 ```python
 >>> from persiantools.jdatetime import JalaliDateTime
 >>> import datetime, pytz
 
+# Get the current Jalali datetime
 >>> JalaliDateTime.now()
-JalaliDateTime(1395, 4, 18, 1, 43, 24, 720505)
+JalaliDateTime(1403, 8, 18, 12, 48, 54, 569082)
 
->>> JalaliDateTime.now().to_gregorian()                                     # Jalali to Gregorian
-datetime.datetime(2016, 7, 8, 1, 43, 24, 720505)
+# Convert Jalali datetime to Gregorian
+>>> JalaliDateTime.now().to_gregorian()
+datetime.datetime(2024, 11, 8, 12, 48, 54, 569082)
 
->>> JalaliDateTime.to_jalali(datetime.datetime(1988, 5, 4, 14, 0, 0, 0))    # Gregorian to Jalali
+# Convert Gregorian datetime to Jalali
+>>> JalaliDateTime.to_jalali(datetime.datetime(1988, 5, 4, 14, 0, 0, 0))
 JalaliDateTime(1367, 2, 14, 14, 0)
 
->>> JalaliDateTime.fromtimestamp(578723400, pytz.timezone("Asia/Tehran"))   # Timestamp to Jalali
+# Create a timezone-aware Jalali datetime from a timestamp
+>>> JalaliDateTime.fromtimestamp(578723400, pytz.timezone("Asia/Tehran"))
 JalaliDateTime(1367, 2, 14, 8, 0, tzinfo=<DstTzInfo 'Asia/Tehran' +0330+3:30:00 STD>)
 
 >>> JalaliDateTime.now(pytz.utc)
 JalaliDateTime(1395, 4, 17, 21, 23, 53, 474618, tzinfo=<UTC>)
 ```
 
-### Format
+### Formatting
 
 Based on python `strftime()` behavior
 
@@ -78,39 +86,44 @@ Based on python `strftime()` behavior
 >>> from persiantools.jdatetime import JalaliDate, JalaliDateTime
 >>> import pytz
 
+# ISO formatting
 >>> JalaliDate(1367, 2, 14).isoformat()
 '1367-02-14'
 
+# Custom date formatting
 >>> JalaliDate(1395, 3, 1).strftime("%Y/%m/%d")
 '1395/03/01'
 
+# Custom datetime formatting
 >>> JalaliDateTime(1369, 7, 1, 14, 0, 10, 0, pytz.utc).strftime("%c")
 'Yekshanbeh 01 Mehr 1369 14:00:10'
-
->>> JalaliDateTime.now(pytz.utc).strftime("%I:%M:%S.%f %p %z %Z")
-'01:49:22.518523 PM +0000 UTC'
 ```
 
-### Digits/Characters Tools
+### Digits and Character Conversion
 
 ```python
 >>> from persiantools import characters, digits
 
+# Convert English digits to Persian
 >>> digits.en_to_fa("0987654321")
 '۰۹۸۷۶۵۴۳۲۱'
 
+# Convert Arabic digits to Persian
 >>> digits.ar_to_fa("٠٩٨٧٦٥٤٣٢١")
 '۰۹۸۷۶۵۴۳۲۱'
 
+# Convert Persian digits to English
 >>> digits.fa_to_en("۰۹۸۷۶۵۴۳۲۱")
 '0987654321'
 
+# Convert numbers to Persian words
 >>> digits.to_word(9512026)
 'نه میلیون و پانصد و دوازده هزار و بیست و شش'
 
 >>> digits.to_word(15.007)
 'پانزده و هفت هزارم'
 
+# Convert Arabic to Persian characters
 >>> characters.ar_to_fa("كيك")
 'کیک'
 ```
@@ -137,21 +150,19 @@ JalaliDate(1395, 3, 21, Jomeh)
 datetime.timedelta(365)
 ```
 
-### Serializing and de-serializing
+### Serializing and Deserializing
 
 ```python
 >>> from persiantools.jdatetime import JalaliDate
 >>> import pickle
 
->>> # Serializing
->>> file = open("save.p", "wb")
->>> pickle.dump(JalaliDate(1367, 2, 14), file)
->>> file.close()
+# Serialize a Jalali date to a file
+>>> with open("save.p", "wb") as file:
+>>>     pickle.dump(JalaliDate(1367, 2, 14), file)
 
->>> # de-serializing
->>> file = open("save.p", "rb")
->>> jalali = pickle.load(file)
->>> file.close()
+# Deserialize from a file
+>>> with open("save.p", "rb") as file:
+>>>     jalali = pickle.load(file)
 >>> jalali
 JalaliDate(1367, 2, 14, Chaharshanbeh)
 ```

{persiantools-4.2.0 → persiantools-5.1.0}/persiantools/__init__.py

@@ -7,7 +7,7 @@
 
 __title__ = "persiantools"
 __url__ = "https://github.com/majiidd/persiantools"
-__version__ = "4.2.0"
+__version__ = "5.1.0"
 __build__ = __version__
 __author__ = "Majid Hajiloo"
 __author_email__ = "majid.hajiloo@gmail.com"

{persiantools-4.2.0 → persiantools-5.1.0}/persiantools/characters.py

@@ -1,4 +1,18 @@
-from persiantools import utils
+from persiantools.utils import replace
+
+CHARACTER_MAP_AR_TO_FA = {
+    "دِ": "د",
+    "بِ": "ب",
+    "زِ": "ز",
+    "ذِ": "ذ",
+    "شِ": "ش",
+    "سِ": "س",
+    "ى": "ی",
+    "ي": "ی",
+    "ك": "ک",
+}
+
+CHARACTER_MAP_FA_TO_AR = {"ی": "ي", "ک": "ك"}
 
 
 def ar_to_fa(string: str) -> str:
@@ -21,19 +35,7 @@ def ar_to_fa(string: str) -> str:
     if not isinstance(string, str):
         raise TypeError("Input must be of type str")
 
-    characters_map = {
-        "دِ": "د",
-        "بِ": "ب",
-        "زِ": "ز",
-        "ذِ": "ذ",
-        "شِ": "ش",
-        "سِ": "س",
-        "ى": "ی",
-        "ي": "ی",
-        "ك": "ک",
-    }
-
-    return utils.replace(string, characters_map)
+    return replace(string, CHARACTER_MAP_AR_TO_FA)
 
 
 def fa_to_ar(string: str) -> str:
@@ -56,6 +58,4 @@ def fa_to_ar(string: str) -> str:
     if not isinstance(string, str):
         raise TypeError("Input must be of type str")
 
-    characters_map = {"ی": "ي", "ک": "ك"}
-
-    return utils.replace(string, characters_map)
+    return replace(string, CHARACTER_MAP_FA_TO_AR)

{persiantools-4.2.0 → persiantools-5.1.0}/persiantools/digits.py

@@ -1,59 +1,9 @@
-import re
-from typing import Tuple
-
-EN_TO_FA_MAP = {
-    "0": "۰",
-    "1": "۱",
-    "2": "۲",
-    "3": "۳",
-    "4": "۴",
-    "5": "۵",
-    "6": "۶",
-    "7": "۷",
-    "8": "۸",
-    "9": "۹",
-}
-AR_TO_FA_MAP = {
-    "٠": "۰",
-    "١": "۱",
-    "٢": "۲",
-    "٣": "۳",
-    "٤": "۴",
-    "٥": "۵",
-    "٦": "۶",
-    "٧": "۷",
-    "٨": "۸",
-    "٩": "۹",
-}
-FA_TO_EN_MAP = {
-    "۰": "0",
-    "۱": "1",
-    "۲": "2",
-    "۳": "3",
-    "۴": "4",
-    "۵": "5",
-    "۶": "6",
-    "۷": "7",
-    "۸": "8",
-    "۹": "9",
-}
-FA_TO_AR_MAP = {
-    "۰": "٠",
-    "۱": "١",
-    "۲": "٢",
-    "۳": "٣",
-    "۴": "٤",
-    "۵": "٥",
-    "۶": "٦",
-    "۷": "٧",
-    "۸": "٨",
-    "۹": "٩",
-}
+from typing import Union
 
-EN_TO_FA_REGEX = re.compile("|".join(EN_TO_FA_MAP.keys()))
-AR_TO_FA_REGEX = re.compile("|".join(AR_TO_FA_MAP.keys()))
-FA_TO_EN_REGEX = re.compile("|".join(FA_TO_EN_MAP.keys()))
-FA_TO_AR_REGEX = re.compile("|".join(FA_TO_AR_MAP.keys()))
+EN_TO_FA_MAP = str.maketrans("0123456789", "۰۱۲۳۴۵۶۷۸۹")
+AR_TO_FA_MAP = str.maketrans("٠١٢٣٤٥٦٧٨٩", "۰۱۲۳۴۵۶۷۸۹")
+FA_TO_EN_MAP = str.maketrans("۰۱۲۳۴۵۶۷۸۹", "0123456789")
+FA_TO_AR_MAP = str.maketrans("۰۱۲۳۴۵۶۷۸۹", "٠١٢٣٤٥٦٧٨٩")
 
 ONES = ("یک", "دو", "سه", "چهار", "پنج", "شش", "هفت", "هشت", "نه")
 TENS = ("بیست", "سی", "چهل", "پنجاه", "شصت", "هفتاد", "هشتاد", "نود")
@@ -85,12 +35,14 @@ DECISION = {
     20: lambda n, depth: RANGE[n - 10],
     100: lambda n, depth: TENS[n // 10 - 2] + _to_word(n % 10, True),
     1000: lambda n, depth: HUNDREDS[n // 100 - 1] + _to_word(n % 100, True),
-    1000000: lambda n, depth: _to_word(n // 1000, depth) + BIG_RANGE[0] + _to_word(n % 1000, True),
-    1000000000: lambda n, depth: _to_word(n // 1000000, depth) + BIG_RANGE[1] + _to_word(n % 1000000, True),
-    1000000000000: lambda n, depth: _to_word(n // 1000000000, depth) + BIG_RANGE[2] + _to_word(n % 1000000000, True),
-    1000000000000000: lambda n, depth: _to_word(n // 1000000000000, depth)
+    1_000_000: lambda n, depth: _to_word(n // 1_000, depth) + BIG_RANGE[0] + _to_word(n % 1_000, True),
+    1_000_000_000: lambda n, depth: _to_word(n // 1_000_000, depth) + BIG_RANGE[1] + _to_word(n % 1_000_000, True),
+    1_000_000_000_000: lambda n, depth: _to_word(n // 1_000_000_000, depth)
+    + BIG_RANGE[2]
+    + _to_word(n % 1_000_000_000, True),
+    1_000_000_000_000_000: lambda n, depth: _to_word(n // 1_000_000_000_000, depth)
     + BIG_RANGE[3]
-    + _to_word(n % 1000000000000, True),
+    + _to_word(n % 1_000_000_000_000, True),
 }
 
 
@@ -117,7 +69,10 @@ def en_to_fa(string: str) -> str:
     >>> print(converted)
     ۰۱۲۳۴۵۶۷۸۹
     """
-    return EN_TO_FA_REGEX.sub(lambda x: EN_TO_FA_MAP[x.group()], string)
+    if not isinstance(string, str):
+        raise TypeError("Input must be a string")
+
+    return string.translate(EN_TO_FA_MAP)
 
 
 def ar_to_fa(string: str) -> str:
@@ -139,7 +94,10 @@ def ar_to_fa(string: str) -> str:
     >>> print(converted)
     ۰۱۲۳۴۵۶۷۸۹
     """
-    return AR_TO_FA_REGEX.sub(lambda x: AR_TO_FA_MAP[x.group()], string)
+    if not isinstance(string, str):
+        raise TypeError("Input must be a string")
+
+    return string.translate(AR_TO_FA_MAP)
 
 
 def fa_to_en(string: str) -> str:
@@ -161,7 +119,10 @@ def fa_to_en(string: str) -> str:
     >>> print(converted)
     0123456789
     """
-    return FA_TO_EN_REGEX.sub(lambda x: FA_TO_EN_MAP[x.group()], string)
+    if not isinstance(string, str):
+        raise TypeError("Input must be a string")
+
+    return string.translate(FA_TO_EN_MAP)
 
 
 def fa_to_ar(string: str) -> str:
@@ -183,7 +144,10 @@ def fa_to_ar(string: str) -> str:
     >>> print(converted)
     ٠١٢٣٤٥٦٧٨٩
     """
-    return FA_TO_AR_REGEX.sub(lambda x: FA_TO_AR_MAP[x.group()], string)
+    if not isinstance(string, str):
+        raise TypeError("Input must be a string")
+
+    return string.translate(FA_TO_AR_MAP)
 
 
 def _to_word(number: int, depth: bool) -> str:
@@ -195,7 +159,7 @@ def _to_word(number: int, depth: bool) -> str:
 
     Parameters:
     number (int): The number to be converted.
-    depth (bool): A flag indicating if the function is called recursively.
+    depth (bool): Indicates if the function is called recursively.
 
     Returns:
     str: The Persian word representation of the number.
@@ -250,23 +214,24 @@ def _floating_number_to_word(number: float, depth: bool) -> str:
     if len(right) > 14:
         raise OutOfRangeException("You are allowed to use 14 digits for a floating point")
 
-    if len(str(right).strip("0")) > 0:
+    if right.strip("0"):
         left_word = _to_word(int(left), False)
-        result = "{}{} {}".format(
-            left_word + DELI if left_word != ZERO else "",
-            _to_word(int(right), False),
-            MANTISSA[len(str(right).rstrip("0")) - 1],
+        mantissa_index = len(right.rstrip("0")) - 1
+        if mantissa_index >= len(MANTISSA):
+            raise ValueError("Fractional part is too long")
+        result = (
+            f"{left_word + DELI if left_word != ZERO else ''}{_to_word(int(right), False)} {MANTISSA[mantissa_index]}"
         )
         if number < 0:
             return NEGATIVE + result
         return result
     else:
         if number < 0:
-            return NEGATIVE + (_to_word(int(left), False))
+            return NEGATIVE + _to_word(int(left), False)
         return _to_word(int(left), False)
 
 
-def to_word(number: Tuple[float, int]) -> str:
+def to_word(number: Union[int, float]) -> str:
     """
     Convert a number to its Persian word representation.