ukr_numbers

[!WARNING]
This is a side project. Sometimes it WILL be wrong, especially for longer numbers. Bug reports and PRs very welcome!

Basics

What?

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

The target declination is given using natural language, in other words you show the target declination instead of describing it.

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.

It additionally supports -1 as code for last, the output will be останній declined in the same shape as the numeral would be.

Why?

Declension target as natural language is neat

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 without the need to explicitly parse each one!

More features

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
• agreeing to 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:Multi-word numbers (124) are unsupported, results may be wrong.
сто двадцять четвертою

python3 -m ukr_numbers -124 першою
WARNING:ukr_numbers.nums:Multi-word numbers (-124) are unsupported, results may be wrong.
мінус сто двадцять четвертою

python3 -m ukr_numbers -1 першою
WARNING:ukr_numbers.nums:Multi-word numbers (124) are unsupported, results may be wrong.
останньою

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 (десятка, десяток)
• Fractions (дві з половиною тисячі)

Known bugs

Numbers that take multiple words in Ukrainian (23 → двадцять три) now have weak support, except:

• 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