TH-Menu 0.2.2

Умная система вложенных меню с кнопкой 'Назад' для nextcord

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

TH_Menu — библиотека для создания вложенных меню в Discord с использованием nextcord. Позволяет быстро и удобно создавать иерархические меню с кнопками.

📖 Подробнее в Официальной вики TH_Menu

Для установки:

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-ботов легко создавать удобные, масштабируемые и локализованные меню без лишнего кода и сложных настроек.