pykodaribot 0.1.0

Python SDK для создания ботов в Kodari Messenger

pykodaribot

Python SDK для создания ботов в Kodari Messenger.

Документация: docs.kodari.ru

Установка

pip install pykodaribot

Требования: Python 3.9+

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

import asyncio
from pykodaribot import Bot, Dispatcher, filters

bot = Bot("bot_ВАШ_ТОКЕН")
dp = Dispatcher()

@dp.message(filters.command("start"))
async def start(msg):
    await msg.answer("Привет!")

@dp.message()
async def echo(msg):
    if msg.text:
        await msg.reply(msg.text)

asyncio.run(dp.start_polling(bot))

Токен

Напишите @BotFather в мессенджере, введите /newbot и следуйте инструкциям.

API

Bot

Метод	Описание
get_me()	Информация о боте
send_message(chat_id, text, reply_to_message_id, reply_markup)	Отправить текст
send_photo(chat_id, media, caption, reply_to_message_id)	Отправить фото
send_document(chat_id, media, caption, reply_to_message_id)	Отправить файл
send_video(chat_id, media, caption, reply_to_message_id)	Отправить видео
send_audio(chat_id, media, caption, reply_to_message_id)	Отправить аудио
edit_message_text(chat_id, message_id, text, reply_markup)	Редактировать сообщение
delete_message(chat_id, message_id)	Удалить сообщение
get_updates(offset, timeout, limit)	Получить апдейты
answer_callback_query(callback_query_id)	Ответить на callback
set_my_commands(commands)	Установить команды меню
get_my_commands()	Получить команды меню
set_my_name(name)	Изменить имя бота
set_my_description(description)	Изменить описание
set_my_short_description(short_description)	Изменить краткое описание
get_chat(chat_id)	Информация о чате

Dispatcher

dp = Dispatcher()

@dp.message(*filters)          # новое сообщение
@dp.edited_message(*filters)   # изменённое сообщение
@dp.callback_query(*filters)   # нажатие inline-кнопки

Фильтры

from pykodaribot import filters

filters.command("start", "help")        # команды /start или /help
filters.text(r"привет|hello")           # regex по тексту
filters.callback_data("yes")            # точное совпадение callback_data
filters.callback_data_prefix("action:") # callback_data начинается с префикса

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

from pykodaribot import InlineKeyboardMarkup, InlineKeyboardButton

keyboard = InlineKeyboardMarkup(inline_keyboard=[
    [
        InlineKeyboardButton(text="Да", callback_data="yes"),
        InlineKeyboardButton(text="Нет", callback_data="no"),
    ],
    [
        InlineKeyboardButton(text="Открыть сайт", url="https://kodari.ru"),
    ],
])

await msg.answer("Выберите:", reply_markup=keyboard)

Отправка медиа

media принимает путь к файлу, Path, bytes или file-like объект:

await bot.send_photo(chat_id, "photo.jpg", caption="Смотри!")
await bot.send_photo(chat_id, Path("/tmp/image.png"))
await bot.send_document(chat_id, open("report.pdf", "rb"))

with open("clip.mp4", "rb") as f:
    await bot.send_video(chat_id, f, caption="Видео")

Примеры

• examples/echo_bot.py — эхо-бот
• examples/inline_bot.py — inline-кнопки и счётчик
• examples/commands_bot.py — команды меню