maxio 0.1.0

Асинхронный фреймворк для MAX Bot API в стиле FastAPI

maxio

Асинхронный Python-фреймворк для MAX Bot API
с внедрением зависимостей по аннотациям типов.

---

Объявляйте в сигнатуре хэндлера то, что нужно, — фреймворк подставит из контекста апдейта сам:

@app.message(Command("start"))
async def start(message: Message, bot: Bot):
    await message.answer("Привет!")

Никаких context["bot"], никакого middleware_data. Просто типы.

Установка

pip install maxio

Python 3.10+, зависимости: httpx + pydantic v2.

Быстрый старт

Получите токен у @MasterBot:

import os
from maxio import MaxBot, Message, CallbackQuery, Command, InlineKeyboard
from maxio.keyboards import Button

app = MaxBot(token=os.environ["MAX_TOKEN"])


@app.message(Command("start"))
async def start(message: Message):
    kb = InlineKeyboard().row(Button.callback("Нажми меня", "ping"))
    await message.answer("Привет! Я готов к работе.", keyboard=kb)


@app.callback()
async def on_ping(query: CallbackQuery):
    await query.answer(notification="Понг!")


@app.message()
async def echo(message: Message):
    await message.reply(message.text or "")


if __name__ == "__main__":
    app.run()

MAX_TOKEN=<ваш_токен> python bot.py

Внедрение зависимостей

Тип	Когда доступен
Message	message_created, message_edited, callback
CallbackQuery	message_callback
User	отправитель/инициатор события
Chat	message_chat_created
Update	всегда (сырой апдейт)
Bot	всегда (HTTP-клиент, прямой доступ к API)

Несовместимый тип → понятная ошибка MaxError с описанием проблемы.

Декораторы событий

@app.message(*filters)          # новые сообщения
@app.message_edited(*filters)   # изменённые сообщения
@app.callback(*filters)         # нажатия inline-кнопок
@app.startup()                  # bot_started
@app.event(*update_types)       # любые типы апдейтов

Несколько хэндлеров — первый подходящий выигрывает (first-match-wins).

Фильтры

from maxio import Command, CallbackPayload

@app.message(Command("help"))
async def help_cmd(message: Message): ...

@app.callback(CallbackPayload("buy"))
async def buy(query: CallbackQuery): ...

# Произвольный callable — тоже фильтр
@app.message(lambda u: u.message and len(u.message.text or "") > 100)
async def long_message(message: Message): ...

Inline-клавиатуры

from maxio import InlineKeyboard
from maxio.keyboards import Button

kb = (
    InlineKeyboard()
    .row(Button.callback("Да", "yes"), Button.callback("Нет", "no"))
    .row(Button.link("Сайт", "https://example.com"))
)
await message.answer("Выберите:", keyboard=kb)

Методы API

@app.message()
async def handler(message: Message, bot: Bot):
    me = await bot.get_me()
    await bot.send_message(chat_id=message.recipient.chat_id, text=f"Я — {me.name}")
    await bot.edit_message(message_id=message.message_id, text="Обновлено")
    await bot.delete_message(message_id=message.message_id)
    chats = await bot.get_chats()

Возможности

• Long polling с автоматическим переподключением
• HTTP-клиент: get_me, send_message, edit_message, delete_message, get_messages, get_chats, answer_callback, get_updates
• Декораторы: message, message_edited, callback, startup, event
• DI по аннотациям типов — работает из коробки, без Depends()
• Фильтры: Command, CallbackPayload, любой Callable
• Inline-клавиатуры: callback / link / request_geo_location
• Сахар: message.answer(), message.reply(), query.answer()
• Pydantic v2, py.typed, mypy --strict ✅

---

Спонсоры

sudoteach.com Генеральный спонсор. Онлайн-школа программирования — там есть курс «Боты на maxio»: от установки до продакшна.

bothost.ru Официальный партнёр. Хостинг для ботов MAX и Telegram — деплой в один клик, мониторинг, автозапуск.

Лицензия

MIT