qazaq-inflector 0.1.0

Склонение казахских имен по падежам

Qazaq Inflector

Библиотека для склонения казахских имен и фамилий по падежам. Поддерживает 6 основных падежей казахского языка.

Установка

Установите пакет через pip:

pip install qazaq_inflector

Qazaq Inflector — библиотека на Python для склонения казахских имён, ФИО и личных местоимений по падежам.

Возможности

• Склоняет одиночные имена по всем семи казахским падежам:
  • nominative, genitive, dative, accusative, locative, ablative, instrumental
• Поддерживает фамилию, имя, отчество (ФИО):
  • части, оканчивающиеся на ұлы или қызы (патронимика) не склоняются
  • разбивает ФИО по пробелам и дефисам
• Склоняет личные местоимения: мен, біз, сен, сіз, ол
• Генерирует множественное число: -дар/-дер
• Формирует полную таблицу склонений через метод declension()

Установка

pip install qazaq_inflector

Быстрый старт

from qazaq_inflector import QazaqNameInflector

inflector = QazaqNameInflector()

# Склонение одиночного имени
print(inflector.inflect("Нұрлан", "genitive"))       # Нұрланның
print(inflector.inflect("Нұрлан", "locative"))       # Нұрланнда

# Склонение ФИО
print(inflector.inflect("Абай Құнанбаев", "dative"))   # Абайға Құнанбаевге

# Склонение местоимений
print(inflector.inflect("Мен", "ablative"))           # Меннен
print(inflector.inflect("Сіз", "instrumental"))      # Сізбен

# Множественное число
print(inflector.pluralize("Нұрлан"))                   # Нұрландар

# Полная таблица
table = inflector.declension("Нұрлан")
for case, (sing, plur) in table.items():
    print(f"{case}: {sing} / {plur}")

API

inflect(name: Optional[str], case: str) -> Optional[str]

Склоняет name по падежу case. Если name равен None или пустая строка, возвращает оригинал.

pluralize(name: str) -> str

Возвращает множественную форму name с учётом гармонии: дар или дер.

declension(name: str) -> Dict[str, tuple]

Возвращает словарь всех падежей { case: (singular, plural) }.

Тесты

git clone https://github.com/zhandos717/qazaq_inflector.git
cd qazaq_inflector
pip install -e .[dev]
pytest

Лицензия

Проект распространяется под лицензией MIT.

---

Автор: Zhandos Zhandarbekov
Email: [e-mail]