Есть код телеграм бота на python aiogram 3. Мне нужно его фрагментировать на отдельные…
- User
Есть код телеграм бота на python aiogram 3. Мне нужно его фрагментировать на отдельные файлы, как это делают профессиональные разработчики телеграм ботов. Дай дерево каталогов и приведи полный и рабочий код каждого файла. Вот код программы:
import os import random import asyncio import logging from functools import partial from aiogram import Bot, Dispatcher, types from aiogram.types import Message from aiogram.fsm.context import FSMContext from aiogram.fsm.state import StatesGroup, State from aiogram.fsm.storage.memory import MemoryStorage from aiogram.filters import Command, StateFilter from gradio_client import Client
Настройка логирования
logging.basicConfig(level=logging.INFO) logger = logging.getLogger(name)
Инициализация токена из переменных окружения
#API_TOKEN = os.getenv('TELEGRAM_API_TOKEN') #if not API_TOKEN:
raise ValueError("Не задан API_TOKEN для бота")
API_TOKEN = '7977254577:AAHKEj9kEqUG8ukaYdkS2ZYzeerq89SzbQE'
Инициализация бота и диспетчера
bot = Bot(token=API_TOKEN) storage = MemoryStorage() dp = Dispatcher(storage=storage)
Определяем карты Старших Арканов
MAJOR_ARCANA = [ '0 The Fool', 'I The Magician', 'II The High Priestess', 'III The Empress', 'IV The Emperor', 'V The Hierophant', 'VI The Lovers', 'VII The Chariot', 'VIII Strength', 'IX The Hermit', 'X Wheel of Fortune', 'XI Justice', 'XII The Hanged Man', 'XIII Death', 'XIV Temperance', 'XV The Devil', 'XVI The Tower', 'XVII The Star', 'XVIII The Moon', 'XIX The Sun', 'XX Judgement', 'XXI The World' ]
Определяем масти и ранги для Младших Арканов
SUITS = ['Wands', 'Cups', 'Swords', 'Pentacles'] RANKS = ['Ace', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'Page', 'Knight', 'Queen', 'King']
Формируем список Младших Арканов
MINOR_ARCANA = [f'{rank} of {suit}' for suit in SUITS for rank in RANKS]
Объединяем Старшие и Младшие Арканы в колоду
FULL_DECK = MAJOR_ARCANA + MINOR_ARCANA
Создаём группу состояний для машины состояний
class Form(StatesGroup): waiting_for_question = State()
@dp.message(Command("start")) async def cmd_start(message: Message): """Обработчик команды /start.""" await message.answer("Привет! Я Таро-бот. Напиши /taro, чтобы сделать расклад.")
@dp.message(Command("help")) async def cmd_help(message: Message): """Обработчик команды /help.""" help_text = ( "Привет! Я Таро-бот. Вот что я могу:\n" "/start - Начать взаимодействие\n" "/taro - Сделать расклад Таро\n" "Просто выберите команду и следуйте инструкциям." ) await message.answer(help_text)
@dp.message(Command("taro")) async def cmd_taro(message: Message, state: FSMContext): """Обработчик команды /taro для начала расклада.""" current_state = await state.get_state() if current_state == Form.waiting_for_question: await message.answer("Вы уже находитесь в процессе расклада. Пожалуйста, введите ваш вопрос.") return await message.answer("Пожалуйста, введи свой вопрос:") await state.set_state(Form.waiting_for_question) logger.info(f"Пользователь {message.from_user.id} начал новый расклад.")
async def async_predict(client, **kwargs): """Асинхронный вызов метода predict клиента Gradio.""" return await asyncio.to_thread(client.predict, **kwargs)
@dp.message(StateFilter(Form.waiting_for_question)) async def process_question(message: Message, state: FSMContext): """Обработка вопроса пользователя и возврат результата расклада.""" try: # Создаём и перемешиваем локальную копию колоды local_deck = FULL_DECK.copy() random.shuffle(local_deck) logger.info("Колодка успешно перемешана.")
# Выбираем первые 3 карты из перемешанной колоды selected_cards = local_deck[:3] cards_str = ', '.join(selected_cards) logger.info(f"Выбранные карты для пользователя {message.from_user.id}: {cards_str}") # Формируем вопрос к внешнему сервису question = ( f"Ты эксперт в гадании по картам Таро. " f"Мой вопрос - {message.text}. " f"Дай мне инсайт при раскладе {cards_str}. " ) logger.info(f"Сформированный вопрос: {question}") # Инициализируем клиента Gradio client = Client("yuntian-deng/ChatGPT4") logger.info("Инициализирован Gradio клиент.") # Выполняем асинхронный запрос к внешнему сервису result = await async_predict( client, inputs=question, top_p=1, temperature=1, chat_counter=0, chatbot=[], api_name="/predict" ) logger.info(f"Получен ответ от сервиса: {result}") # Обрабатываем результат if result and len(result) > 0 and len(result[0]) > 0 and len(result[0][0]) > 1: response = str(result[0][0][1]) else: response = "Нет ответа от сервиса." # Отправляем ответ пользователю await message.answer(response, parse_mode="Markdown") logger.info(f"Ответ отправлен пользователю {message.from_user.id}") except Exception as e: logger.error(f"Ошибка при обработке вопроса пользователя {message.from_user.id}: {e}") await message.answer("Произошла ошибка при обработке вашего запроса. Пожалуйста, попробуйте позже.") finally: # Сбрасываем состояние независимо от результата await state.clear() logger.info(f"Состояние пользователя {message.from_user.id} сброшено.")@dp.message() async def handle_unknown(message: Message): """Обработка неизвестных команд.""" await message.answer("Извините, я не понимаю эту команду. Пожалуйста, используйте /help для справки.")
async def on_shutdown(dp: Dispatcher): """Очистка ресурсов при завершении работы бота.""" await bot.close() await dp.storage.close() await dp.storage.wait_closed() logger.info("Бот успешно остановлен.")
async def main(): """Главная функция для запуска бота.""" try: logger.info("Бот запускается.") await bot.delete_webhook(drop_pending_updates=True) await dp.start_polling(bot, on_shutdown=on_shutdown) except (KeyboardInterrupt, SystemExit): logger.info("Бот остановлен пользователем.")
if name == 'main': asyncio.run(main())
- Assistant
Профессиональная структура проекта помогает поддерживать код чистым, организованным и легко управляемым. Ниже представлена рекомендуемая структура каталогов для вашего Telegram-бота на основе библиотеки
aiogramверсии 3. Каждый функциональный компонент разделен на отдельные файлы и каталоги.Структура Каталогов
telegram_taro_bot/ ├── main.py ├── config.py ├── handlers/ │ ├── __init__.py │ ├── start.py │ ├── help.py │ ├── taro.py │ ├── process_question.py │ └── unknown.py ├── states/ │ ├── __init__.py │ └── form.py ├── services/ │ ├── __init__.py │ └── gradio_service.py ├── utils/ │ ├── __init__.py │ └── deck.py └── requirements.txtОписание Файлов и Каталогов
-
main.py: Основной файл для запуска бота. Инициализирует бота, диспетчер, регистрирует обработчики и запускает поллинг. -
config.py: Файл конфигурации, содержащий токен бота и другие настройки. -
handlers/: Каталог, содержащий обработчики различных команд и сообщений.__init__.py: Регистрация всех обработчиков.start.py: Обработчик команды/start.help.py: Обработчик команды/help.taro.py: Обработчик команды/taro.process_question.py: Обработчик сообщений пользователя в состоянии ожидания вопроса.unknown.py: Обработчик неизвестных команд или сообщений.
-
states/: Каталог, содержащий определение состояний FSM.__init__.py: Импорт всех состояний.form.py: Определение группы состояний для взаимодействия с пользователем.
-
services/: Каталог для внешних сервисов и интеграций.__init__.py: Можно оставить пустым или использовать для общей инициализации сервисов.gradio_service.py: Интеграция с Gradio клиентом для предсказаний.
-
utils/: Каталог для вспомогательных функций и утилит.__init__.py: Можно оставить пустым или использовать для общего импорта утилит.deck.py: Функции для работы с колодой карт Таро.
-
requirements.txt: Список зависимостей проекта.
Полный Код Файлов
1.
requirements.txtaiogram>=3.0.0b7 gradio-clientУбедитесь, что вы установили все зависимости командой:
pip install -r requirements.txt2.
config.py# config.py API_TOKEN = '7977254577:AAHKEj9kEqUG8ukaYdkS2ZYzeerq89SzbQE' # Замените на ваш токен # Рекомендуется использовать переменные окружения для хранения токенов безопасности. # Например, можно использовать библиотеку python-dotenv для загрузки токенов из .env файла.Важно: Хранение токена непосредственно в коде небезопасно. Рекомендуется использовать переменные окружения для хранения чувствительных данных.
3.
handlers/__init__.py# handlers/__init__.py from .start import router as start_router from .help import router as help_router from .taro import router as taro_router from .process_question import router as process_question_router from .unknown import router as unknown_router def setup_handlers(dp): dp.include_router(start_router) dp.include_router(help_router) dp.include_router(taro_router) dp.include_router(process_question_router) dp.include_router(unknown_router)4.
handlers/start.py# handlers/start.py import logging from aiogram import Router from aiogram.filters import Command from aiogram.types import Message router = Router() logger = logging.getLogger(__name__) @router.message(Command("start")) async def cmd_start(message: Message): """Обработчик команды /start.""" await message.answer("Привет! Я Таро-бот. Напиши /taro, чтобы сделать расклад.") logger.info(f"Пользователь {message.from_user.id} использовал команду /start.")5.
handlers/help.py# handlers/help.py import logging from aiogram import Router from aiogram.filters import Command from aiogram.types import Message router = Router() logger = logging.getLogger(__name__) @router.message(Command("help")) async def cmd_help(message: Message): """Обработчик команды /help.""" help_text = ( "Привет! Я Таро-бот. Вот что я могу:\n" "/start - Начать взаимодействие\n" "/taro - Сделать расклад Таро\n" "Просто выберите команду и следуйте инструкциям." ) await message.answer(help_text) logger.info(f"Пользователь {message.from_user.id} запросил помощь.")6.
handlers/taro.py# handlers/taro.py import logging from aiogram import Router from aiogram.filters import Command from aiogram.types import Message from aiogram.fsm.context import FSMContext from states.form import Form router = Router() logger = logging.getLogger(__name__) @router.message(Command("taro")) async def cmd_taro(message: Message, state: FSMContext): """Обработчик команды /taro для начала расклада.""" current_state = await state.get_state() if current_state == Form.waiting_for_question: await message.answer("Вы уже находитесь в процессе расклада. Пожалуйста, введите ваш вопрос.") logger.info(f"Пользователь {message.from_user.id} уже в процессе расклада.") return await message.answer("Пожалуйста, введи свой вопрос:") await state.set_state(Form.waiting_for_question) logger.info(f"Пользователь {message.from_user.id} начал новый расклад.")7.
handlers/process_question.py# handlers/process_question.py import logging from aiogram import Router from aiogram.types import Message from aiogram.fsm.context import FSMContext from aiogram.filters import StateFilter from states.form import Form from utils.deck import shuffle_deck from services.gradio_service import gradio_service router = Router() logger = logging.getLogger(__name__) @router.message(StateFilter(Form.waiting_for_question)) async def process_question(message: Message, state: FSMContext): """Обработка вопроса пользователя и возврат результата расклада.""" try: # Перемешиваем колоду local_deck = shuffle_deck() # Выбираем первые 3 карты selected_cards = local_deck[:3] cards_str = ', '.join(selected_cards) logger.info(f"Выбранные карты для пользователя {message.from_user.id}: {cards_str}") # Формируем вопрос к сервису question = ( f"Ты эксперт в гадании по картам Таро. " f"Мой вопрос - {message.text}. " f"Дай мне инсайт при раскладе {cards_str}." ) logger.info(f"Сформированный вопрос: {question}") # Выполняем асинхронный запрос к сервису result = await gradio_service.async_predict( inputs=question, top_p=1, temperature=1, chat_counter=0, chatbot=[], api_name="/predict" ) logger.info(f"Получен ответ от сервиса: {result}") # Обрабатываем результат if result and len(result) > 0 and len(result[0]) > 0 and len(result[0][0]) > 1: response = str(result[0][0][1]) else: response = "Нет ответа от сервиса." # Отправляем ответ пользователю await message.answer(response, parse_mode="Markdown") logger.info(f"Ответ отправлен пользователю {message.from_user.id}") except Exception as e: logger.error(f"Ошибка при обработке вопроса пользователя {message.from_user.id}: {e}") await message.answer("Произошла ошибка при обработке вашего запроса. Пожалуйста, попробуйте позже.") finally: # Сбрасываем состояние независимо от результата await state.clear() logger.info(f"Состояние пользователя {message.from_user.id} сброшено.")8.
handlers/unknown.py# handlers/unknown.py import logging from aiogram import Router from aiogram.types import Message router = Router() logger = logging.getLogger(__name__) @router.message() async def handle_unknown(message: Message): """Обработка неизвестных команд.""" await message.answer("Извините, я не понимаю эту команду. Пожалуйста, используйте /help для справки.") logger.warning(f"Неизвестная команда от пользователя {message.from_user.id}: {message.text}")9.
states/__init__.py# states/__init__.py from .form import Form10.
states/form.py# states/form.py from aiogram.fsm.state import StatesGroup, State class Form(StatesGroup): waiting_for_question = State()11.
services/__init__.py# services/__init__.py # Файл может оставаться пустым или использоваться для общего импорта сервисов.12.
services/gradio_service.py# services/gradio_service.py import asyncio from gradio_client import Client import logging logger = logging.getLogger(__name__) class GradioService: def __init__(self, model_name: str): self.client = Client(model_name) logger.info("Gradio клиент инициализирован.") async def async_predict(self, **kwargs): """Асинхронный вызов метода predict клиента Gradio.""" return await asyncio.to_thread(self.client.predict, **kwargs) # Инициализируем сервис один раз при импорте gradio_service = GradioService("yuntian-deng/ChatGPT4")13.
utils/__init__.py# utils/__init__.py # Файл может оставаться пустым или использоваться для общего импорта утилит.14.
utils/deck.py# utils/deck.py import random import logging logger = logging.getLogger(__name__) MAJOR_ARCANA = [ '0 The Fool', 'I The Magician', 'II The High Priestess', 'III The Empress', 'IV The Emperor', 'V The Hierophant', 'VI The Lovers', 'VII The Chariot', 'VIII Strength', 'IX The Hermit', 'X Wheel of Fortune', 'XI Justice', 'XII The Hanged Man', 'XIII Death', 'XIV Temperance', 'XV The Devil', 'XVI The Tower', 'XVII The Star', 'XVIII The Moon', 'XIX The Sun', 'XX Judgement', 'XXI The World' ] SUITS = ['Wands', 'Cups', 'Swords', 'Pentacles'] RANKS = ['Ace', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'Page', 'Knight', 'Queen', 'King'] MINOR_ARCANA = [f'{rank} of {suit}' for suit in SUITS for rank in RANKS] FULL_DECK = MAJOR_ARCANA + MINOR_ARCANA def shuffle_deck(): local_deck = FULL_DECK.copy() random.shuffle(local_deck) logger.info("Колодка успешно перемешана.") return local_deck15.
main.py# main.py import asyncio import logging from aiogram import Bot, Dispatcher from aiogram.fsm.storage.memory import MemoryStorage from config import API_TOKEN from handlers import setup_handlers # Настройка логирования logging.basicConfig( level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s", ) logger = logging.getLogger(__name__) # Инициализация бота и диспетчера bot = Bot(token=API_TOKEN, parse_mode="Markdown") storage = MemoryStorage() dp = Dispatcher(storage=storage) # Регистрация обработчиков setup_handlers(dp) async def on_shutdown(dp: Dispatcher): """Очистка ресурсов при завершении работы бота.""" await bot.close() await dp.storage.close() await dp.storage.wait_closed() logger.info("Бот успешно остановлен.") async def main(): """Главная функция для запуска бота.""" try: logger.info("Бот запускается.") await bot.delete_webhook(drop_pending_updates=True) await dp.start_polling(bot, on_shutdown=on_shutdown) except (KeyboardInterrupt, SystemExit): logger.info("Бот остановлен пользователем.") if __name__ == '__main__': asyncio.run(main())Запуск Бота
-
Установка зависимостей
Убедитесь, что вы установили все необходимые зависимости:
pip install -r requirements.txt -
Настройка Токена
В файле
config.pyзамените'7977254577:AAHKEj9kEqUG8ukaYdkS2ZYzeerq89SzbQE'на ваш собственный токен, полученный у @BotFather. -
Запуск Бота
Запустите бота командой:
python main.py
Дополнительные Рекомендации
-
Использование Переменных Окружения:
Для повышения безопасности рекомендуется хранить токен бота и другие чувствительные данные в переменных окружения. Вы можете использовать библиотеку
python-dotenvдля загрузки переменных из.envфайла.Пример
config.pyс использованиемpython-dotenv:# config.py import os from dotenv import load_dotenv load_dotenv() # Загрузка переменных из .env файла API_TOKEN = os.getenv('TELEGRAM_API_TOKEN') if not API_TOKEN: raise ValueError("Не задан API_TOKEN для бота")Пример
.envфайла:TELEGRAM_API_TOKEN=ваш_токен_здесьНе забудьте добавить
.envв.gitignore, чтобы не распространять чувствительные данные. -
Обработка Исключений:
Убедитесь, что все возможные исключения корректно обрабатываются, чтобы бот не падал при возникновении ошибок.
-
Логирование:
Настройте более продвинутое логирование (например, запись в файл) для удобства отладки и мониторинга работы бота.
-
Тестирование:
Добавьте тесты для проверки функциональности бота и его компонентов.
-
Документация:
Поддерживайте актуальную документацию по проекту для облегчения командной работы и сопровождения.
Следуя данной структуре и рекомендациям, вы создадите масштабируемый и удобный в поддержке Telegram-бот на
aiogramверсии 3. -