Третья часть: сделаны обработчики команд

BotCode/routers/__init__.py

@@ -1,4 +1,18 @@
 # BotCode/routers/__init__.py
-# Инициализация модуля routers, для основных роутеров
+# Инициализация пакета routers, для работы с асинхронными обработчиками
 
-# Экспортирование модулей во внешние слои проекта
+from aiogram import Router
+from .commands import router as commands_head_router
+from .common import router as common_head_router
+
+# Объявление главного роутера и настройка экспорта модулей
+__all__ = ("router",)
+router = Router(name="all_routers")
+
+
+# Список подключаемых роутеров сверху-вниз
+router.include_routers(
+    commands_head_router,
+)
+
+router.include_routers(common_head_router)

BotCode/routers/commands/__init__.py

@@ -0,0 +1,16 @@
+# BotCode/routers/commands/__init__.py
+# Инициализация модуля commands, для основных команд бота
+
+from aiogram import Router
+from .user_cmd import router as user_cmd_router
+
+
+# Объявление роутера и настройка экспорта модулей
+__all__ = ("router",)
+router = Router(name="commands_head_router")
+
+
+# Список подключаемых роутеров сверху-вниз
+router.include_routers(
+    user_cmd_router,
+)

BotCode/routers/commands/list_commands.py

@@ -0,0 +1,32 @@
+# BotCode/routers/commands/list_commands.py
+# Создание списка команд для бота
+
+from aiogram import Router, types
+from aiogram.filters import Command
+from BotLibrary import *
+
+from .user_cmd.start_cmd import start_cmd
+from .user_cmd.help_cmd import help_cmd
+
+# Создание роутера и настройка экспорта модулей
+__all__ = ("router", "set_commands")
+router = Router(name="list_cmd_routers")
+
+# Список ключевых слов для команды "setcommands"
+secret_keywords = ["setcommands", "setcommand", "ыуесщььфтвы", "ыуесщььфтв",
+                   "setcmd", "setcmds", "ыуесьв",]
+
+
+# Хэндлер на команду /setcommands для использования в чате
+@router.message(
+    #F.from_user.id.func(lambda user_id: str(user_id) in DataID.important.keys()),
+                Command(*secret_keywords, prefix=BotVar.prefix, ignore_case=True))
+@router.message(
+    #F.from_user.id.func(lambda user_id: str(user_id) in DataID.important.keys()),
+                F.text.lower().in_(secret_keywords))
+async def set_commands():
+    bot_commands = [
+        types.BotCommand(command=start_cmd.name, description=start_cmd.description),
+        types.BotCommand(command=help_cmd.name, description=help_cmd.description),
+    ]
+    await bot.set_my_commands(bot_commands)

BotCode/routers/commands/user_cmd/__init__.py

@@ -0,0 +1,19 @@
+# BotCode/routers/commands/user_cmd/__init__.py
+# Инициализация модуля user_cmd, для пользовательских команд бота
+
+# Экспортирование модулей во внешние слои проекта
+from aiogram import Router
+from .start_cmd import start_cmd
+from .help_cmd import help_cmd
+
+# Объявление роутера и настройка экспорта модулей
+__all__ = ("router",)
+router = Router(name="user_cmd_router")
+
+
+# Список подключаемых роутеров сверху-вниз
+router.include_routers(
+    help_cmd.router,
+)
+
+router.include_routers(start_cmd.router)

BotCode/routers/commands/user_cmd/help_cmd.py

@@ -0,0 +1,12 @@
+# BotCode/routers/commands/user_cmd/help_cmd.py
+# Работа с командой /help, для вывода помощи пользователю
+
+from .user_cmd_class import CommandHandler
+
+# Создание команды /help с нужными параметрами
+help_cmd = CommandHandler(
+    name="help",
+    description="Получить помощь",
+    keywords=["help", "info", "помощь", "инфо", "информация", "рудз", "штащ", "byaj", "gjvjom", "byajhvfwbz"],
+    text_msg="Привет! Это команда помощи. Тут ты можешь узнать, как пользоваться ботом.",
+)

BotCode/routers/commands/user_cmd/start_cmd.py

@@ -0,0 +1,13 @@
+# BotCode/routers/commands/user_cmd/start_cmd.py
+# # Работа с командой /start, для запуска бота
+
+from .user_cmd_class import CommandHandler
+
+# Создание команды /start с нужными параметрами
+start_cmd = CommandHandler(
+    name="start",
+    description="Запустить бота",
+    keywords=["start", "старт", "запуск", "пуск", "on", "вкл", "с", "s", "ы",
+              "ыефке", "cnfhn", "pfgecr", "gecr", "щт", "drk", "restart", "куыефке"],
+    text_msg="Старт!",
+)

BotCode/routers/commands/user_cmd/user_cmd_class.py

@@ -0,0 +1,51 @@
+# BotCode/routers/commands/user_cmd_class.py
+# Класс-шаблон для создания новых команд
+
+from aiogram import Router, types
+from aiogram.filters import Command
+from BotLibrary import *
+
+# Класс-шаблон для команд
+class CommandHandler:
+    def __init__(self, name: str, description: str,
+                 keywords: list, text_msg: str,
+                 keyboard=None, prefix = BotVar.prefix,
+                 ignore_case = True,
+                 ):
+        """
+        Универсальный обработчик команд для бота.
+
+        :param name: Имя команды (например, "help").
+        :param description: Описание команды.
+        :param keywords: Список ключевых слов, которые активируют команду.
+        :param text_msg: Текст сообщения, который отправляется пользователю.
+        :param keyboard: Клавиатура, если требуется.
+        """
+        self.router = Router(name=f"{name}_router")
+        self.name = name
+        self.log_type = name.capitalize()
+        self.description = description
+        self.keywords = keywords
+        self.text_msg = text_msg
+        self.keyboard = keyboard
+
+        # Привязываем хэндлер к роутеру
+        self.router.message(
+            Command(*keywords, prefix=prefix, ignore_case=ignore_case)
+        )(self.handler)
+        self.router.message(F.text.lower().in_(keywords))(self.handler)
+
+
+    async def handler(self, message: types.Message):
+        """Основной хэндлер команды."""
+        user = f"@{message.from_user.username or message.from_user.id}"
+        try:
+            logger.bind(log_type=self.name.capitalize(), user=user).info(f"использовал(а) команду /{self.name}")
+            await message.reply(
+                text=self.text_msg,
+                reply_markup=self.keyboard() if self.keyboard else None,
+            )
+
+        # Проверка на ошибку
+        except Exception as e:
+            logger.bind(log_type=self.name.capitalize(), user=user).error(f"Ошибка команды: {e}")

BotCode/routers/common/__init__.py

@@ -0,0 +1,13 @@
+# BotCode/routers/common/__init__.py
+# Инициализация пакета common, для работы со всеми сообщениями
+
+from aiogram import Router
+from .messages import router as common_messages_router
+
+
+# Объявление роутера и настройка экспорта модулей
+__all__ = ("router",)
+router = Router(name="common_head_router")
+
+# Идет самым последним, если другие роутеры не сработали
+router.include_router(common_messages_router)

BotCode/routers/common/messages.py

@@ -0,0 +1,15 @@
+# BotCode/routers/common/messages.py
+# Обработчик всех сообщений
+
+from aiogram import Router, types
+from BotLibrary import *
+
+# Настройка экспорта модулей и роутера
+__all__ = ("router",)
+router = Router(name="common_msg_router")
+
+
+# Хэндлер на все сообщения и записывает данные
+@router.message()
+async def handle_all_messages(message: types.Message):
+    await logger_msg(message)