Руководство по созданию модульного Telegram бота на Python и aiogram

[CoderP]

Создание Telegram бота, способного эффективно масштабироваться и легко обновляться, требует продуманного подхода к организации кода. В этом руководстве мы покажем, как можно использовать Python и библиотеку aiogram для создания модульного Telegram бота. Модульный подход означает, что каждый отдельный функционал бота будет разделен на свой собственный модуль, который можно легко обновить или заменить, не затрагивая остальные части кода.

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

Структура нашего проекта будет выглядеть следующим образом:

telegram_bot/
|---- bot.py
|---- handlers/
|    |---- __init__.py
|    |---- start.py
|    |---- help.py

telegram_bot/bot.py:
Это основной скрипт, который инициализирует бота и регистрирует обработчики команд.

from aiogram import Bot, Dispatcher
from aiogram.contrib.fsm_storage.memory import MemoryStorage
from handlers import register_handlers

API_TOKEN = 'YOUR_BOT_TOKEN_HERE'

bot = Bot(token=API_TOKEN)
dp = Dispatcher(bot, storage=MemoryStorage())

def main():
    register_handlers(dp)
  
    from aiogram import executor
    executor.start_polling(dp, skip_updates=True)


if __name__ == '__main__':
    main()

telegram_bot/handlers/init.py:
В этом файле мы импортируем и регистрируем все обработчики команд.

from .start import register_start_handlers
from .help import register_help_handlers

def register_handlers(dp):
    register_start_handlers(dp)
    register_help_handlers(dp)

telegram_bot/handlers/start.py:
Этот модуль определяет обработчик для команды /start.

from aiogram import types

async def start_command(message: types.Message):
    await message.reply("Привет! Я ваш бот.")

def register_start_handlers(dp):
    dp.register_message_handler(start_command, commands=['start'])

telegram_bot/handlers/help.py:
Этот модуль определяет обработчик для команды /help.

from aiogram import types

async def help_command(message: types.Message):
    await message.reply("Список команд...")

def register_help_handlers(dp):
    dp.register_message_handler(help_command, commands=['help'])

В этой структуре проекта, когда вы захотите добавить новый функционал, вам нужно будет создать новый файл в папке handlers, определить в нем обработчик для новой команды и зарегистрировать этот обработчик в handlers/__init__.py. Этот подход делает ваш код чистым, организованным и легко расширяемым.