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 TeamsBot.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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.