A tool to convert numbers (int, float) into Persian words
Project description
num2fawords
This package provides functions to convert a number (int or float) to a Persian word form.
Usage
>>> from num2fawords import cardinal_words, ordinal_words
>>> cardinal_words(1984)
'یک هزار و نهصد و هشتاد و چهار'
>>> ordinal_words(1232)
'یک هزار و دویست و سی و دوم'
>>> ordinal_words(123)
'یکصد و بیست و سوم'
Obviously, cardinal_words is used convert to cardinal form and ordinal_words for ordinal from.
Use can also pass in floating point numbers:
>>> cardinal_words(19.75)
'نوزده ممیز هفتاد و پنج صدم'
This is the default setting. If you’d like to ommit the word “ممیز” from the output and use “و” instead of it, you can:
>>> import num2fawords
>>> num2fawords.MOMAYEZ # default value:
' ممیز '
>>> num2fawords.MOMAYEZ = ' و '
>>> num2fawords.cardinal_words(19.75)
'نوزده و هفتاد و پنج صدم'
Also some people prefer, for example, “صد و هفتاد” over its other form “یکصد و هفتاد”. This library uses the second form which is the form used on official Iranian banknotes. But it can be changed:
>>> num2fawords.cardinal_words(170)
'یکصد و هفتاد'
>>> num2fawords.SADGAN
['', 'یکصد', 'دویست', 'سیصد', 'چهارصد', 'پانصد', 'ششصد', 'هفتصد', 'هشتصد', 'نهصد']
>>> num2fawords.SADGAN[1] = 'صد'
>>> num2fawords.cardinal_words(170)
'صد و هفتاد'
Command line
The program can also be invoked from the command line:
>python num2fawords
usage: num2fawords [-h] [--ordinal] [--cardinal] number
num2fawords: error: the following arguments are required: number
>python num2fawords 13
سیزدهم
>python num2fawords -o 13
سیزدهم
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for num2fawords-0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 34067e8bc31fbc4948e09334444879bec122e68c6b9c484d63d4d7659ea749d6 |
|
MD5 | e70eb708f517edb8e93a1c8977d9fefe |
|
BLAKE2b-256 | 7051cc6e60514c9cb0e3672a70e0ad4498ccfa2be8bccc7e8694fb064d57a6ce |