Skip to main content

aiovkteams

Асинхронная библиотека для создания ботов в VK Workspace (VK Teams) в стиле aiogram 3.x.

Установка

pip install aiovkteams

С поддержкой PostgreSQL-хранилища FSM:

pip install aiovkteams[postgres]

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

import asyncio
from aiovkteams.bot import Bot
from aiovkteams.dispatcher import Dispatcher
from aiovkteams.filters import Command
from aiovkteams.fsm.storage.memory import MemoryStorage
from aiovkteams.types import HandlerContext
from aiovkteams.fsm import FSMContext

bot = Bot(token="001.xxxxxxxxxx")
dp  = Dispatcher(bot, storage=MemoryStorage())

@dp.message(Command("start"))
async def cmd_start(ctx: HandlerContext, fsm: FSMContext):
    await ctx.reply("Привет!")

asyncio.run(dp.start_polling())

Возможности

  • Polling — long polling из коробки, автоматический реконнект
  • FSM — конечный автомат состояний (MemoryStorage / PostgresStorage)
  • Роутеры — разбивка хендлеров по модулям (Router)
  • Inline-клавиатуры — кнопки с callback, ссылками, стилями (primary, attention)
  • Middleware — обработка запросов до/после хендлеров
  • Фильтры — Command, F.data, StateFilter и произвольные
  • Отправка файлов — загрузка изображений с кэшированием по fileId

Примеры

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

from aiovkteams.types import InlineKeyboard

kb = (
    InlineKeyboard()
    .button("Подтвердить", callback_data="confirm", style="primary")
    .row()
    .button("Отмена", callback_data="cancel", style="attention")
)

await ctx.reply("Подтвердите действие:", inline_keyboard=kb.build())

Callback-хендлер

from aiovkteams.filters import F

@dp.callback_query(F.data == "confirm")
async def on_confirm(ctx: HandlerContext, fsm: FSMContext):
    await ctx.answer_callback()
    await ctx.edit_text("Подтверждено!")

FSM

from aiovkteams.fsm import State, StatesGroup
from aiovkteams.filters import StateFilter

class Form(StatesGroup):
    WaitingName = State()

@dp.message(Command("form"))
async def cmd_form(ctx: HandlerContext, fsm: FSMContext):
    await fsm.set_state(Form.WaitingName)
    await ctx.reply("Введите имя:")

@dp.message(Form.WaitingName)
async def process_name(ctx: HandlerContext, fsm: FSMContext):
    name = ctx.event.text
    await fsm.clear()
    await ctx.reply(f"Привет, {name}!")

Отправка изображения

with open("photo.jpg", "rb") as f:
    result = await bot.upload_file(
        chat_id=ctx.chat_id,
        file=f.read(),
        filename="photo.jpg",
        caption="Подпись к фото",
    )
# result["fileId"] — можно сохранить для повторной отправки без загрузки

Роутеры

# handlers/catalog.py
from aiovkteams.router import Router
router = Router(name="catalog")

@router.message(Command("catalog"))
async def cmd_catalog(ctx: HandlerContext, fsm: FSMContext):
    ...

# main.py
dp.include_router(catalog.router)

Changelog

0.3.7

  • Dispatcher: сетевые ошибки polling (включая эпизодические 404 от VK Teams) логируются на уровне DEBUG вместо WARNING

0.3.6

  • HandlerContext.reply и HandlerContext.send_file — добавлен параметр format_str для передачи форматирования VK Teams
  • Bot.send_text и Bot.send_file — при передаче format_str параметр parseMode автоматически исключается из запроса (они взаимоисключающие)

0.3.5

  • Message.text_format — новое поле, захватывает поле format из входящего события VK Teams (JSON-строка с диапазонами стилей)
  • Bot.send_file — добавлен параметр format_str для передачи форматирования в подписи к файлу

0.3.4

  • Message.file_ids — новое свойство, возвращает список всех fileId из вложений сообщения
  • PostgresStorage: исправлен ValueError при чтении JSONB-данных — asyncpg возвращал строку вместо dict, теперь оба формата обрабатываются корректно

0.3.3

  • Исправлен KeyError: 'userId' в User.from_dict при обработке ChatMemberEvent (некоторые системные события VK Teams не содержат поле userId)

0.3.2

  • Добавлено PostgreSQL-хранилище FSM (aiovkteams.fsm.storage.postgres)
  • Поддержка upload_voice для голосовых сообщений

0.3.1

  • Добавлены стили кнопок: primary, attention, base
  • Поддержка кнопок-ссылок (url=)

0.3.0

  • Первый публичный релиз
  • Polling, FSM (MemoryStorage), Router, Middleware, Inline-клавиатуры

Metadata

Release files for aiovkteams 0.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiovkteams 0.3.7
File Size Uploaded Provenance Actions
aiovkteams-0.3.7.tar.gz 25.3 kB Without provenance Details for aiovkteams-0.3.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aiovkteams 0.3.7
File Interpreter ABI Platform Actions
aiovkteams-0.3.7-py3-none-any.whl Python 3 none any Details for aiovkteams-0.3.7-py3-none-any.whl

Total release size: 54.0 kB

Release files / aiovkteams-0.3.7.tar.gz

Download URL aiovkteams-0.3.7.tar.gz
Size 25.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ab9cfa8e3a6a9c0525ab2654860ab960c933b2d092d2b803557b8916f8435bcb
BLAKE2b-256 checksum
How to use checksums
faa07e67be2edb07b9cf536a3cd664d5e2bfd7e550c6a1ee72004a756a49e294
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / aiovkteams-0.3.7-py3-none-any.whl

Download URL aiovkteams-0.3.7-py3-none-any.whl
Size 28.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b8bc74a1c139b735461b81f10507ea5a2745bf09f41b61f77833b1d1cdeff03
BLAKE2b-256 checksum
How to use checksums
ee7abd09f77199dbbbf047c59b3b6448540c9394b57946200f09ede4c0320487
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Security for aiovkteams 0.3.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page