DeclensionHelper-Py

Этот пакет предназначен для работы со склонениями существительных в таких языках, как русский и украинский.

---

Требования

• Python >= 3.9

---

Описание

Библиотека предоставляет три основных метода:

• set(key: str, forms: list[ str1, str2, str3 ]) – сохранить формы склонения
• get(number, key: str) – вернёт нужную форму по числу
• format(number, key: str, template: str = "{item} {form}") – вернёт отформатированную строку

---

Пример использования

Примеры так же можно найти в тесте DeclensionTest.py

from Declension import Declension

# Устанавливаем формы склонения
Declension.set("usd", ["доллар", "доллара", "долларов"])

print(Declension.get(1, "usd"))  # доллар
print(Declension.get(2, "usd"))  # доллара
print(Declension.get(5, "usd"))  # долларов
print(Declension.get(0, "usd"))  # долларов

Форматирование строки

from Declension import Declension

# Устанавливаем формы склонения
Declension.set("руб", ["рубль", "рубля", "рублей"])

print(Declension.format(-10, "руб"))  # -10 рублей
print(Declension.format(1.99, "руб"))  # 1 рубль
print(Declension.format(2, "руб"))  # 2 рубля
print(Declension.format(5, "руб"))  # 5 рублей

Пользовательский шаблон

from Declension import Declension

# Устанавливаем формы склонения
Declension.set("грн", ["гривня", "гривні", "гривень"])

# Формируем возвращаемый шаблон текста.
mask = "На вашому рахунку: {item} {form}"

print(Declension.format(-11.29, "грн", mask))  # На вашому рахунку: -12 гривень
print(Declension.format(0, "грн", mask))  # На вашому рахунку: 0 гривень
print(Declension.format(1, "грн", mask))  # На вашому рахунку: 1 гривня
print(Declension.format("2.99", "грн", mask))  # На вашому рахунку: 2 гривні
print(Declension.format(10.01, "грн", mask))  # На вашому рахунку: 10 гривень