pyromax 0.7.1

Асинхронный, модульный фреймворк для юзерботов в MAX Messenger

Pyromax 🚀

Асинхронный, модульный и современный фреймворк для создания юзерботов в MAX Messenger.

Pyromax создан для тех, кто устал от "лапши" в одном файле. Мы перенесли лучшие практики из aiogram 3.x в мир MAX: роутеры, строгая типизация и удобная архитектура.

---

🔥 Почему Pyromax?

В отличие от других библиотек, мы ставим Developer Experience (DX) на первое место:

• 📦 Система Роутеров (Routers): Разбивайте бота на файлы и плагины. Никаких файлов на 2000 строк.
• ⚡ Скорость: Полностью асинхронное ядро на aiohttp и websockets.
• clean_code: Архитектура, вдохновленная aiogram. Если вы писали ботов для Telegram, вы будете чувствовать себя как дома.
• 🛠 Гибкость: Встроенный Dispatcher и Observer паттерн.

---

Возможности

• Асинхронное ядро.
• Dispatcher и Router.
• Фильтры и паттерны.
• Форматирование сообщений.
• Типизация основных объектов.

---

---

Установка

uv add pyromax

---

Разработка

uv add --dev mkdocs
uv run mkdocs serve

🗺 Roadmap (Планы развития)

Мы активно развиваем библиотеку и стремимся сделать её стандартом для MAX.

📍 Текущий статус (Alpha)

• Core: Полностью асинхронное ядро (MaxApi, Dispatcher).
• Routers: Модульная система (разбиение бота на файлы).
• Types: Строгая типизация всех объектов (Update, Message, Attachments).
• Observer: Система паттернов и фильтров для хендлеров.
• Magic Filters: Удобный синтаксис фильтров (как F.text.startswith("!")).
• Middlewares: Перехват событий до хендлеров (логирование, анти-флуд, базы данных).

🚧 В разработке

• FSM (Finite State Machine): Машина состояний для создания сценариев (опросы, диалоги, формы).

🔮 Планы на будущее

• Документация: Полноценный сайт с документацией и примерами.
• Плагины: Готовые модули для администрирования чатов.

---

📞 Контакты

Telegram разработчика: ТЫК

🤝 Contributing

Мы рады любой помощи! Если вы хотите предложить фичу или исправить баг:

1. Форкните репозиторий.
2. Создайте ветку (git checkout -b feature/NewFeature).
3. Откройте Pull Request.

📄 Лицензия

MIT License. Свободно используйте в своих проектах.