Metadata-Version: 2.1
Name: TH-Menu
Version: 0.2.2
Summary: Умная система вложенных меню с кнопкой 'Назад' для nextcord
Home-page: https://github.com/Thomson-Hate/TH-Menu/blob/main/README.md
Author: Ivan (Thomson Hate)
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Framework :: AsyncIO
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt


# TH_Menu — Возможности и Описание


## TH_Menu — библиотека для создания вложенных меню в Discord с использованием nextcord. Позволяет быстро и удобно создавать иерархические меню с кнопками.
📖 Подробнее в [Официальной вики TH_Menu](https://github.com/Thomson-Hate/TH-Menu/wiki/TH_Menu#-th_menu--%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8C-%D1%83%D0%BC%D0%BD%D1%8B%D1%85-%D0%B2%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%BD%D1%8B%D1%85-%D0%BC%D0%B5%D0%BD%D1%8E-%D0%B4%D0%BB%D1%8F-discord)
## Для установки:
```py
pip install TH_Menu
```
## Основные функции:

1. Вложенные меню
   - Поддержка неограниченного количества уровней вложенности подкатегорий.
   - Автоматическая навигация по меню с кнопкой "Назад" для возврата на предыдущий уровень.

2. Локализация
   - Возможность задавать заголовки, подписи и описания меню и кнопок в виде словарей с переводами на разные языки.
   - Автоматическое определение языка пользователя по Interaction.locale.
   - Поддержка fallback-языка.

3. Поиск по меню
   - Команда или кнопка для поиска по названию пунктов меню.
   - Поддержка fuzzy-поиска для частичного совпадения.
   - Отображение результатов поиска с возможностью перехода к найденным пунктам.

4. Загрузка структуры меню из файлов
   - Поддержка форматов JSON и YAML.
   - Автоматическое преобразование строк с названиями функций в callable объекты.
   - Валидация структуры меню при загрузке.

5. Пагинация
   - Автоматическое разбиение подменю на страницы, если количество пунктов превышает лимит (по умолчанию 25).
   - Кнопки управления страницами: вперед, назад, индикатор текущей страницы.
   - Сохранение позиции при возврате назад.

6. SmartAction
   - Обёртка для действий с дополнительными свойствами.
   - Возможность задавать условие отображения кнопки (например, проверка прав пользователя).
   - Поддержка локализованных меток и описаний для кнопок.
   - Удобное объединение callback и метаданных.

7. Настройки
   - Параметры timeout для автоматического закрытия меню по таймауту.
   - Параметр ephemeral для отправки сообщений только видимых пользователю.

8. Автообновление
   - При запуске проверяется наличие новой версии библиотеки на PyPI.
   - В случае обновления выводится подсказка с командой обновления.

9. Поддержка slash-команд и обычных команд Discord.

---

Этот модуль позволяет разработчикам Discord-ботов легко создавать удобные, масштабируемые и локализованные меню без лишнего кода и сложных настроек.
