pykodaribot 0.1.0__tar.gz

pykodaribot-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: pykodaribot
+Version: 0.1.0
+Summary: Python SDK для создания ботов в Kodari Messenger
+License: MIT
+Project-URL: Homepage, https://msg.kodari.ru
+Project-URL: Documentation, https://docs.kodari.ru/
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9
+
+# pykodaribot
+
+Python SDK для создания ботов в [Kodari Messenger](https://msg.kodari.ru).
+
+**Документация:** [docs.kodari.ru](https://docs.kodari.ru/)
+
+## Установка
+
+```bash
+pip install pykodaribot
+```
+
+**Требования:** Python 3.9+
+
+## Быстрый старт
+
+```python
+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
+
+```python
+dp = Dispatcher()
+
+@dp.message(*filters)          # новое сообщение
+@dp.edited_message(*filters)   # изменённое сообщение
+@dp.callback_query(*filters)   # нажатие inline-кнопки
+```
+
+### Фильтры
+
+```python
+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-клавиатура
+
+```python
+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 объект:
+
+```python
+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/echo_bot.py) — эхо-бот
+- [`examples/inline_bot.py`](examples/inline_bot.py) — inline-кнопки и счётчик
+- [`examples/commands_bot.py`](examples/commands_bot.py) — команды меню

pykodaribot-0.1.0/README.md

@@ -0,0 +1,119 @@
+# pykodaribot
+
+Python SDK для создания ботов в [Kodari Messenger](https://msg.kodari.ru).
+
+**Документация:** [docs.kodari.ru](https://docs.kodari.ru/)
+
+## Установка
+
+```bash
+pip install pykodaribot
+```
+
+**Требования:** Python 3.9+
+
+## Быстрый старт
+
+```python
+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
+
+```python
+dp = Dispatcher()
+
+@dp.message(*filters)          # новое сообщение
+@dp.edited_message(*filters)   # изменённое сообщение
+@dp.callback_query(*filters)   # нажатие inline-кнопки
+```
+
+### Фильтры
+
+```python
+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-клавиатура
+
+```python
+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 объект:
+
+```python
+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/echo_bot.py) — эхо-бот
+- [`examples/inline_bot.py`](examples/inline_bot.py) — inline-кнопки и счётчик
+- [`examples/commands_bot.py`](examples/commands_bot.py) — команды меню

pykodaribot-0.1.0/pykodaribot/__init__.py

@@ -0,0 +1,31 @@
+from .bot import Bot, BotError
+from .dispatcher import Dispatcher, Router
+from .types import (
+    BotCommand,
+    CallbackQuery,
+    Chat,
+    InlineKeyboardButton,
+    InlineKeyboardMarkup,
+    Message,
+    Update,
+    User,
+)
+from . import filters
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Bot",
+    "BotError",
+    "Dispatcher",
+    "Router",
+    "User",
+    "Chat",
+    "Message",
+    "CallbackQuery",
+    "Update",
+    "InlineKeyboardMarkup",
+    "InlineKeyboardButton",
+    "BotCommand",
+    "filters",
+]

pykodaribot-0.1.0/pykodaribot/bot.py

@@ -0,0 +1,208 @@
+from __future__ import annotations
+from pathlib import Path
+from typing import BinaryIO, List, Optional, Union
+
+import aiohttp
+
+from .types import (
+    BotCommand, Chat, InlineKeyboardMarkup,
+    Message, Update, User,
+)
+
+MediaInput = Union[str, bytes, Path, BinaryIO]
+
+
+class BotError(Exception):
+    def __init__(self, error_code: int, description: str):
+        self.error_code = error_code
+        self.description = description
+        super().__init__(f"[{error_code}] {description}")
+
+
+class Bot:
+    BASE_URL = "https://api.kodari.ru/msg/bot.php"
+
+    def __init__(self, token: str):
+        self._token = token
+        self._headers = {"Authorization": f"Bearer {token}"}
+        self._session: Optional[aiohttp.ClientSession] = None
+
+    async def _get_session(self) -> aiohttp.ClientSession:
+        if self._session is None or self._session.closed:
+            self._session = aiohttp.ClientSession(headers=self._headers)
+        return self._session
+
+    async def close(self) -> None:
+        if self._session and not self._session.closed:
+            await self._session.close()
+
+    async def __aenter__(self) -> "Bot":
+        return self
+
+    async def __aexit__(self, *_) -> None:
+        await self.close()
+
+    async def _get(self, method: str, **params) -> object:
+        session = await self._get_session()
+        params["method"] = method
+        async with session.get(self.BASE_URL, params=params) as r:
+            data = await r.json()
+        if not data.get("ok"):
+            raise BotError(data.get("error_code", 0), data.get("description", "Unknown"))
+        return data["result"]
+
+    async def _post(self, method: str, **body) -> object:
+        session = await self._get_session()
+        url = f"{self.BASE_URL}?method={method}"
+        body = {k: v for k, v in body.items() if v is not None}
+        async with session.post(url, json=body) as r:
+            data = await r.json()
+        if not data.get("ok"):
+            raise BotError(data.get("error_code", 0), data.get("description", "Unknown"))
+        return data["result"]
+
+    async def _post_media(self, method: str, chat_id: int, media: MediaInput,
+                          caption: Optional[str], reply_to_message_id: Optional[int]) -> object:
+        session = await self._get_session()
+        url = f"{self.BASE_URL}?method={method}"
+        form = aiohttp.FormData()
+        form.add_field("chat_id", str(chat_id))
+        if caption is not None:
+            form.add_field("caption", caption)
+        if reply_to_message_id is not None:
+            form.add_field("reply_to_message_id", str(reply_to_message_id))
+        if isinstance(media, (str, Path)):
+            path = Path(media)
+            with open(path, "rb") as f:
+                form.add_field("media", f, filename=path.name)
+                async with session.post(url, data=form) as r:
+                    data = await r.json()
+        else:
+            filename = getattr(media, "name", "file")
+            form.add_field("media", media, filename=Path(filename).name)
+            async with session.post(url, data=form) as r:
+                data = await r.json()
+        if not data.get("ok"):
+            raise BotError(data.get("error_code", 0), data.get("description", "Unknown"))
+        return data["result"]
+
+    def _markup(self, reply_markup) -> Optional[dict]:
+        if reply_markup is None:
+            return None
+        return reply_markup.to_dict() if hasattr(reply_markup, "to_dict") else reply_markup
+
+    async def get_me(self) -> User:
+        return User.from_dict(await self._get("getMe"))
+
+    async def send_message(
+        self,
+        chat_id: int,
+        text: str,
+        reply_to_message_id: Optional[int] = None,
+        reply_markup: Optional[Union[InlineKeyboardMarkup, dict]] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post(
+                "sendMessage",
+                chat_id=chat_id,
+                text=text,
+                reply_to_message_id=reply_to_message_id,
+                reply_markup=self._markup(reply_markup),
+            ),
+            self,
+        )
+
+    async def send_photo(
+        self,
+        chat_id: int,
+        media: MediaInput,
+        caption: Optional[str] = None,
+        reply_to_message_id: Optional[int] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post_media("sendPhoto", chat_id, media, caption, reply_to_message_id),
+            self,
+        )
+
+    async def send_document(
+        self,
+        chat_id: int,
+        media: MediaInput,
+        caption: Optional[str] = None,
+        reply_to_message_id: Optional[int] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post_media("sendDocument", chat_id, media, caption, reply_to_message_id),
+            self,
+        )
+
+    async def send_video(
+        self,
+        chat_id: int,
+        media: MediaInput,
+        caption: Optional[str] = None,
+        reply_to_message_id: Optional[int] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post_media("sendVideo", chat_id, media, caption, reply_to_message_id),
+            self,
+        )
+
+    async def send_audio(
+        self,
+        chat_id: int,
+        media: MediaInput,
+        caption: Optional[str] = None,
+        reply_to_message_id: Optional[int] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post_media("sendAudio", chat_id, media, caption, reply_to_message_id),
+            self,
+        )
+
+    async def edit_message_text(
+        self,
+        chat_id: int,
+        message_id: int,
+        text: str,
+        reply_markup: Optional[Union[InlineKeyboardMarkup, dict]] = None,
+    ) -> Message:
+        return Message.from_dict(
+            await self._post("editMessageText", chat_id=chat_id, message_id=message_id,
+                             text=text, reply_markup=self._markup(reply_markup)),
+            self,
+        )
+
+    async def delete_message(self, chat_id: int, message_id: int) -> bool:
+        return bool(await self._post("deleteMessage", chat_id=chat_id, message_id=message_id))
+
+    async def get_updates(
+        self,
+        offset: int = 0,
+        timeout: int = 20,
+        limit: int = 100,
+    ) -> List[Update]:
+        result = await self._get("getUpdates", offset=offset, timeout=timeout, limit=limit)
+        return [Update.from_dict(u, self) for u in result]
+
+    async def answer_callback_query(self, callback_query_id: str) -> bool:
+        return bool(await self._post("answerCallbackQuery", callback_query_id=callback_query_id))
+
+    async def set_my_commands(self, commands: List[BotCommand]) -> bool:
+        return bool(await self._post("setMyCommands", commands=[c.to_dict() for c in commands]))
+
+    async def get_my_commands(self) -> List[BotCommand]:
+        result = await self._get("getMyCommands")
+        return [BotCommand(c["command"], c["description"]) for c in result]
+
+    async def set_my_name(self, name: str) -> bool:
+        return bool(await self._post("setMyName", name=name))
+
+    async def set_my_description(self, description: str) -> bool:
+        return bool(await self._post("setMyDescription", description=description))
+
+    async def set_my_short_description(self, short_description: str) -> bool:
+        return bool(await self._post("setMyShortDescription", short_description=short_description))
+
+    async def get_chat(self, chat_id: int) -> Chat:
+        return Chat.from_dict(await self._get("getChat", chat_id=chat_id))

pykodaribot-0.1.0/pykodaribot/dispatcher.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+import asyncio
+import logging
+from typing import Callable, List, Tuple
+
+from .bot import Bot, BotError
+from .filters import Filter
+from .types import CallbackQuery, Message, Update
+
+logger = logging.getLogger(__name__)
+
+HandlerList = List[Tuple[List[Filter], Callable]]
+
+
+class Router:
+    def __init__(self):
+        self._message_handlers: HandlerList = []
+        self._edited_message_handlers: HandlerList = []
+        self._callback_query_handlers: HandlerList = []
+
+    def message(self, *filters: Filter):
+        def decorator(func: Callable):
+            self._message_handlers.append((list(filters), func))
+            return func
+        return decorator
+
+    def edited_message(self, *filters: Filter):
+        def decorator(func: Callable):
+            self._edited_message_handlers.append((list(filters), func))
+            return func
+        return decorator
+
+    def callback_query(self, *filters: Filter):
+        def decorator(func: Callable):
+            self._callback_query_handlers.append((list(filters), func))
+            return func
+        return decorator
+
+    async def _run_handlers(self, handlers: HandlerList, obj) -> None:
+        for filters, handler in handlers:
+            if all([await f(obj) for f in filters]):
+                try:
+                    await handler(obj)
+                except Exception:
+                    logger.exception("Ошибка в обработчике %s", handler.__name__)
+                return
+
+    async def process_update(self, update: Update) -> None:
+        if update.message:
+            await self._run_handlers(self._message_handlers, update.message)
+        elif update.edited_message:
+            await self._run_handlers(self._edited_message_handlers, update.edited_message)
+        elif update.callback_query:
+            await self._run_handlers(self._callback_query_handlers, update.callback_query)
+
+
+class Dispatcher(Router):
+    async def start_polling(self, bot: Bot, timeout: int = 20) -> None:
+        offset = 0
+        logger.info("Поллинг запущен")
+        try:
+            while True:
+                try:
+                    updates = await bot.get_updates(offset=offset, timeout=timeout)
+                    for update in updates:
+                        offset = update.update_id + 1
+                        await self.process_update(update)
+                except BotError as e:
+                    logger.error("Ошибка API: %s", e)
+                    await asyncio.sleep(1)
+                except asyncio.CancelledError:
+                    raise
+                except Exception:
+                    logger.exception("Ошибка поллинга")
+                    await asyncio.sleep(1)
+        finally:
+            await bot.close()
+            logger.info("Поллинг остановлен")

pykodaribot-0.1.0/pykodaribot/filters.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+import re
+from typing import Union
+
+from .types import CallbackQuery, Message
+
+
+class Filter:
+    async def __call__(self, obj) -> bool:
+        raise NotImplementedError
+
+
+class CommandFilter(Filter):
+    def __init__(self, *commands: str):
+        self.commands = {c.lstrip("/") for c in commands}
+
+    async def __call__(self, msg: Message) -> bool:
+        if not msg.text:
+            return False
+        first = msg.text.split()[0].lstrip("/").split("@")[0]
+        return first in self.commands
+
+
+class TextFilter(Filter):
+    def __init__(self, pattern: Union[str, re.Pattern]):
+        self.pattern = re.compile(pattern) if isinstance(pattern, str) else pattern
+
+    async def __call__(self, msg: Message) -> bool:
+        return bool(msg.text and self.pattern.search(msg.text))
+
+
+class CallbackDataFilter(Filter):
+    def __init__(self, data: str):
+        self.data = data
+
+    async def __call__(self, cb: CallbackQuery) -> bool:
+        return cb.data == self.data
+
+
+class CallbackDataPrefixFilter(Filter):
+    def __init__(self, prefix: str):
+        self.prefix = prefix
+
+    async def __call__(self, cb: CallbackQuery) -> bool:
+        return cb.data is not None and cb.data.startswith(self.prefix)
+
+
+def command(*commands: str) -> CommandFilter:
+    return CommandFilter(*commands)
+
+
+def text(pattern: Union[str, re.Pattern]) -> TextFilter:
+    return TextFilter(pattern)
+
+
+def callback_data(data: str) -> CallbackDataFilter:
+    return CallbackDataFilter(data)
+
+
+def callback_data_prefix(prefix: str) -> CallbackDataPrefixFilter:
+    return CallbackDataPrefixFilter(prefix)

pykodaribot-0.1.0/pykodaribot/types.py

@@ -0,0 +1,138 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Any, List, Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .bot import Bot
+
+
+@dataclass
+class User:
+    id: int
+    is_bot: bool
+    first_name: str
+    username: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "User":
+        return cls(
+            id=d["id"],
+            is_bot=d.get("is_bot", False),
+            first_name=d.get("first_name", ""),
+            username=d.get("username"),
+        )
+
+
+@dataclass
+class Chat:
+    id: int
+    type: str
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Chat":
+        return cls(id=d["id"], type=d.get("type", ""))
+
+
+@dataclass
+class InlineKeyboardButton:
+    text: str
+    callback_data: Optional[str] = None
+    url: Optional[str] = None
+
+    def to_dict(self) -> dict:
+        d: dict = {"text": self.text}
+        if self.callback_data is not None:
+            d["callback_data"] = self.callback_data
+        if self.url is not None:
+            d["url"] = self.url
+        return d
+
+
+@dataclass
+class InlineKeyboardMarkup:
+    inline_keyboard: List[List[InlineKeyboardButton]] = field(default_factory=list)
+
+    def to_dict(self) -> dict:
+        return {
+            "inline_keyboard": [
+                [btn.to_dict() for btn in row]
+                for row in self.inline_keyboard
+            ]
+        }
+
+
+@dataclass
+class Message:
+    message_id: int
+    chat: Chat
+    date: int
+    from_user: Optional[User] = None
+    text: Optional[str] = None
+    _bot: Any = field(default=None, repr=False, compare=False)
+
+    @classmethod
+    def from_dict(cls, d: dict, bot: Any = None) -> "Message":
+        return cls(
+            message_id=d["message_id"],
+            chat=Chat.from_dict(d["chat"]),
+            date=d.get("date", 0),
+            from_user=User.from_dict(d["from"]) if "from" in d else None,
+            text=d.get("text"),
+            _bot=bot,
+        )
+
+    async def answer(self, text: str, **kwargs) -> "Message":
+        return await self._bot.send_message(self.chat.id, text, **kwargs)
+
+    async def reply(self, text: str, **kwargs) -> "Message":
+        return await self._bot.send_message(
+            self.chat.id, text, reply_to_message_id=self.message_id, **kwargs
+        )
+
+
+@dataclass
+class CallbackQuery:
+    id: str
+    from_user: User
+    data: Optional[str] = None
+    message: Optional[Message] = None
+    _bot: Any = field(default=None, repr=False, compare=False)
+
+    @classmethod
+    def from_dict(cls, d: dict, bot: Any = None) -> "CallbackQuery":
+        return cls(
+            id=d["id"],
+            from_user=User.from_dict(d["from"]),
+            data=d.get("data"),
+            message=Message.from_dict(d["message"], bot) if "message" in d else None,
+            _bot=bot,
+        )
+
+    async def answer(self) -> None:
+        await self._bot.answer_callback_query(self.id)
+
+
+@dataclass
+class Update:
+    update_id: int
+    message: Optional[Message] = None
+    edited_message: Optional[Message] = None
+    callback_query: Optional[CallbackQuery] = None
+
+    @classmethod
+    def from_dict(cls, d: dict, bot: Any = None) -> "Update":
+        return cls(
+            update_id=d["update_id"],
+            message=Message.from_dict(d["message"], bot) if "message" in d else None,
+            edited_message=Message.from_dict(d["edited_message"], bot) if "edited_message" in d else None,
+            callback_query=CallbackQuery.from_dict(d["callback_query"], bot) if "callback_query" in d else None,
+        )
+
+
+@dataclass
+class BotCommand:
+    command: str
+    description: str
+
+    def to_dict(self) -> dict:
+        return {"command": self.command, "description": self.description}

pykodaribot-0.1.0/pykodaribot.egg-info/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: pykodaribot
+Version: 0.1.0
+Summary: Python SDK для создания ботов в Kodari Messenger
+License: MIT
+Project-URL: Homepage, https://msg.kodari.ru
+Project-URL: Documentation, https://docs.kodari.ru/
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9
+
+# pykodaribot
+
+Python SDK для создания ботов в [Kodari Messenger](https://msg.kodari.ru).
+
+**Документация:** [docs.kodari.ru](https://docs.kodari.ru/)
+
+## Установка
+
+```bash
+pip install pykodaribot
+```
+
+**Требования:** Python 3.9+
+
+## Быстрый старт
+
+```python
+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
+
+```python
+dp = Dispatcher()
+
+@dp.message(*filters)          # новое сообщение
+@dp.edited_message(*filters)   # изменённое сообщение
+@dp.callback_query(*filters)   # нажатие inline-кнопки
+```
+
+### Фильтры
+
+```python
+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-клавиатура
+
+```python
+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 объект:
+
+```python
+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/echo_bot.py) — эхо-бот
+- [`examples/inline_bot.py`](examples/inline_bot.py) — inline-кнопки и счётчик
+- [`examples/commands_bot.py`](examples/commands_bot.py) — команды меню

pykodaribot-0.1.0/pykodaribot.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+pykodaribot/__init__.py
+pykodaribot/bot.py
+pykodaribot/dispatcher.py
+pykodaribot/filters.py
+pykodaribot/types.py
+pykodaribot.egg-info/PKG-INFO
+pykodaribot.egg-info/SOURCES.txt
+pykodaribot.egg-info/dependency_links.txt
+pykodaribot.egg-info/requires.txt
+pykodaribot.egg-info/top_level.txt

pykodaribot-0.1.0/pykodaribot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pykodaribot-0.1.0/pykodaribot.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.9

pykodaribot-0.1.0/pykodaribot.egg-info/top_level.txt

@@ -0,0 +1 @@
+pykodaribot

pykodaribot-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pykodaribot"
+version = "0.1.0"
+description = "Python SDK для создания ботов в Kodari Messenger"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+dependencies = ["aiohttp>=3.9"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Framework :: AsyncIO",
+]
+
+[project.urls]
+Homepage = "https://msg.kodari.ru"
+Documentation = "https://docs.kodari.ru/"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["pykodaribot*"]

pykodaribot-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+