ukr_numbers

Warning

This is a side project, currently pre-alpha. Sometimes it WILL be wrong, especially for longer numbers. You have been warned.

Basics

What?

Convert int numbers (like "3") to (Ukrainian-language) words in a specific declination (третій/три/третьому/третьої).

The target declination is given using natural language, that is: decline any simple number to the declination you need and it'll be used as example/blueprint.

FOR EXAMPLE, if you need "1->в першому вагоні", "2->в другому вагоні", "-1->в останньому вагоні", you can just enter "першому" as your target declension, and all your integers will be transformed to ordinals in the dative case.

Why?

Declension target as natural language

1. I find this easier than remembering the names of everything for an explicit target declension (is it ordinal or cardinal? do I write dative or datv? ..)
2. Automatic templating! I use this package to replace numbers in strings with other numbers without the need to explicitly parse each one!

My own unsolved problem

Even without the natural language target bit, I found no packages that could convert integers to natural language while handling both cardinals and ordinals in different (grammatical) cases and agreed to different numbers and genders.

Examples

>>> from ukr_numbers import Numbers
>>> Numbers().convert_to_auto(231300,"другий")
WARNING:ukr_numbers.nums:Support for multi-word numbers (231300) is bad, errors are likely to happen, you're warned.
'двістітридцятьоднатисячатрьохсотий'

python3 -m ukr_numbers 8 два
вісім
python3 -m ukr_numbers 8 другої
восьмої

# `-1` is a special number denoting "last":
python3 -m ukr_numbers -1 два  #! can't decline it into a number
None
python3 -m ukr_numbers -1 другої
останньої

python3 -m ukr_numbers 124 першою
WARNING:ukr_numbers.nums:Support for multi-word numbers (124) is bad, errors are likely to happen, you're warned.
сто двадцять четвертою

python3 -m ukr_numbers -124 першою
WARNING:ukr_numbers.nums:Support for multi-word numbers (-124) is bad, errors are likely to happen, you're warned.
мінус сто двадцять четвертою

Errors handling

• if "останній"/last can't be inflected in the required way, (e.g. "перший"->"останній" is OK, "один"->??? isn't) None will be returned.
• if anything goes wrong and graceful_failure is enabled, in the worst case scenario the number itself will be returned as string (2 ->'2')

Drawbacks

Explicitly unsupported

• Nouns, like 'десятка', 'десяток'
• Fractions (дві з половиною тисячі)

Known bugs

• Numbers that take multiple words in Ukrainian (23 -> двадцять три) now have weak support, but..
• numbers composed of multiple words in certain cases (pun intended) are only partially correct
  • e.g. (currently) 2000000 двома -> два мільйонами, not двома мільйонами
• Please write tickets for edge cases you find!

Similar projects

Both used in this package:

• num2words
  • multilingual incl. Ukrainian
  • can do inflection by case and partly by gender
  • can't do inflections together with ordinals
  • can't do adjectives (на ПЕРШОМУ місці)
• pymorphy2 does inflection on natural words