num2fawords 0.2

A tool to convert numbers (int, float) into Persian words

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)
'صد و هفتاد'