pymaxbot 0.1.0__tar.gz

pymaxbot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sergey Kurilenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pymaxbot-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: pymaxbot
+Version: 0.1.0
+Summary: Python SDK for MAX messenger bot API
+License: MIT License
+        
+        Copyright (c) 2026 Sergey Kurilenko
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/svkurick/max_bot
+Project-URL: Repository, https://github.com/svkurick/max_bot
+Project-URL: Issues, https://github.com/svkurick/max_bot/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Dynamic: license-file
+
+# max_bot

pymaxbot-0.1.0/README.md

@@ -0,0 +1 @@
+# max_bot

pymaxbot-0.1.0/max_bot/__init__.py

@@ -0,0 +1,19 @@
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("max_bot")
+except PackageNotFoundError:
+    __version__ = "0.0.0"
+
+from .bot import Bot
+from .dispatcher.dispatcher import Dispatcher
+from .polling.polling import run_polling
+from .types.callback import Callback
+
+__all__ = [
+    "__version__",
+    "Bot",
+    "Dispatcher",
+    "run_polling",
+    "Callback",
+]

pymaxbot-0.1.0/max_bot/bot.py

@@ -0,0 +1,114 @@
+import asyncio
+import os
+import httpx
+
+from .client import MaxClient
+from .types.message import Message
+
+
+class Bot:
+
+    def __init__(self, token: str):
+        self.client = MaxClient(token)
+
+    # ─── MESSAGES ─────────────────────────────────────────────────────────────
+
+    async def send_message(self, chat_id: int, text: str, format=None, buttons=None):
+        body = {"text": text}
+        if format:
+            body["format"] = format
+
+        if buttons:
+            body["attachments"] = [_build_keyboard(buttons)]
+
+        params = {"user_id": chat_id}
+        data = await self.client.request("POST", "/messages", json=body, params=params)
+        return Message(data["message"], self)
+
+    async def delete_message(self, mid: str):
+        params = {"message_id": mid}
+        return await self.client.request("DELETE", "/messages", params=params)
+
+    # ─── FILES ────────────────────────────────────────────────────────────────
+
+    async def upload_file(self, file_path: str):
+        r = await self.client.request("POST", "/uploads", type_param="file")
+        upload_url = r.get("url")
+        with open(file_path, "rb") as f:
+            files = {"data": (os.path.basename(file_path), f)}
+            return await self.client.request("POST", upload_url, files=files, base_url_blank=True)
+
+    async def send_document(self, chat_id: int, file_path: str):
+        upload = await self.upload_file(file_path)
+        file_token = upload["token"]
+        body = {
+            "attachments": [{"type": "file", "payload": {"token": file_token}}]
+        }
+        await asyncio.sleep(2)
+        data = await self.client.request("POST", "/messages", json=body, params={"user_id": chat_id})
+        return Message(data["message"], self)
+
+    async def send_documents(self, chat_id: int, file_path: list[str]):
+        for path in file_path:
+            upload = await self.upload_file(path)
+            file_token = upload["token"]
+            body = {
+                "attachments": [{"type": "file", "payload": {"token": file_token}}]
+            }
+            await self.client.request("POST", "/messages", json=body, params={"user_id": chat_id})
+
+    # ─── IMAGES ───────────────────────────────────────────────────────────────
+
+    async def upload_image(self, file_path: str):
+        r = await self.client.request("POST", "/uploads", type_param="image")
+        upload_url = r.get("url")
+        with open(file_path, "rb") as f:
+            files = {"data": (os.path.basename(file_path), f)}
+            result = await self.client.request("POST", upload_url, files=files, base_url_blank=True)
+        # Ответ: {"photos": {"<id>": {"token": "..."}}}
+        photos = result.get("photos", {})
+        token = next(iter(photos.values()))["token"]
+        return {"token": token}
+
+    async def send_image(self, chat_id: int, file_path: str, text: str = None):
+        upload = await self.upload_image(file_path)
+        image_token = upload["token"]
+        body = {"text": text} if text else {}
+        body["attachments"] = [{"type": "image", "payload": {"token": image_token}}]
+        data = await self.client.request("POST", "/messages", json=body, params={"user_id": chat_id})
+        return Message(data["message"], self)
+
+    async def send_images(self, chat_id: int, file_paths: list[str], text: str = None):
+        tokens = []
+        for path in file_paths:
+            upload = await self.upload_image(path)
+            tokens.append(upload["token"])
+        body = {"text": text} if text else {}
+        body["attachments"] = [{"type": "image", "payload": {"token": t}} for t in tokens]
+        await self.client.request("POST", "/messages", json=body, params={"user_id": chat_id})
+
+    # ─── CALLBACKS ────────────────────────────────────────────────────────────
+
+    async def answer_callback(self, callback_id: str, notification: str = None):
+        # API требует notification или message — передаём пробел если нечего показывать
+        body = {"notification": notification or " "}
+        await self.client.request("POST", "/answers", json=body, params={"callback_id": callback_id})
+
+
+# ─── HELPERS ──────────────────────────────────────────────────────────────────
+
+def _build_keyboard(buttons: list[list[dict]]) -> dict:
+    rows = []
+    for row in buttons:
+        btn_row = []
+        for btn in row:
+            btn_row.append({
+                "type": btn.get("type", "callback"),
+                "text": btn["text"],
+                "payload": btn.get("payload", ""),
+            })
+        rows.append(btn_row)
+    return {
+        "type": "inline_keyboard",
+        "payload": {"buttons": rows}
+    }

pymaxbot-0.1.0/max_bot/client.py

@@ -0,0 +1,75 @@
+import httpx
+import asyncio
+
+class MaxClient:
+
+    def __init__(self, token: str, base_url="https://platform-api.max.ru"):
+        self.base_url = base_url
+        self.token = token
+        self.client = httpx.AsyncClient(
+            timeout=httpx.Timeout(
+                connect=10.0,
+                read=60.0,
+                write=10.0,
+                pool=10.0
+            )
+        )
+
+    async def request(
+            self,
+            method: str,
+            path: str,
+            json=None,
+            params=None,
+            files=None,
+            data=None,
+            type_param=None,
+            base_url_blank=False,
+            max_retries=5,
+    ) -> dict:
+        headers = {
+            "Authorization": self.token
+        }
+        if type_param:
+            params = {'type': type_param}
+
+        if base_url_blank:
+            path_url = path
+        else:
+            path_url = f"{self.base_url}{path}"
+
+        delay = 1
+
+        for attempt in range(max_retries):
+            r = await self.client.request(
+                method,
+                path_url,
+                json=json,
+                params=params,
+                files=files,
+                data=data,
+                headers=headers
+            )
+            try:
+                data_resp = r.json()
+            except Exception:
+                data_resp = {}
+
+                # 🔥 проверка attachment.not.ready
+            if (
+                isinstance(data_resp, dict)
+                and data_resp.get("code") == "attachment.not.ready"
+            ):
+                print(f"⏳ attachment not ready, retry {attempt + 1}, sleep {delay}s")
+                await asyncio.sleep(delay)
+                delay += 3
+                continue
+
+            # если статус плохой — падаем
+            if r.is_error:
+                print(f"❌ HTTP {r.status_code} response body:", r.text)
+            r.raise_for_status()
+
+            return data_resp
+
+        raise Exception("❌ Превышено количество попыток (attachment not ready)")

pymaxbot-0.1.0/max_bot/dispatcher/dispatcher.py

@@ -0,0 +1,64 @@
+from ..types.message import Message
+from ..types.callback import Callback
+
+
+class Dispatcher:
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.handlers = []
+        self.callback_handlers = []
+
+    def message(self, commands=None):
+        def decorator(func):
+            self.handlers.append({
+                "func": func,
+                "commands": commands,
+            })
+            return func
+        return decorator
+
+    def callback(self, payloads=None):
+        def decorator(func):
+            self.callback_handlers.append({
+                "func": func,
+                "payloads": payloads,
+            })
+            return func
+        return decorator
+
+    async def process_update(self, update):
+        update_type = update.get("update_type")
+
+        if update_type == "message_callback":
+            await self._process_callback(update)
+        elif "message" in update:
+            await self._process_message(update["message"])
+
+    async def _process_message(self, raw_message: dict):
+        message = Message(raw_message, self.bot)
+        for handler in self.handlers:
+            commands = handler["commands"]
+            if commands:
+                if not message.text:
+                    continue
+                cmd_word = message.text.split()[0]
+                if not any(cmd_word == f"/{cmd}" for cmd in commands):
+                    continue
+            try:
+                await handler["func"](message)
+                break
+            except Exception as e:
+                print("❌ Handler error:", e)
+
+    async def _process_callback(self, update: dict):
+        cb = Callback(update, self.bot)
+        for handler in self.callback_handlers:
+            payloads = handler["payloads"]
+            if payloads and cb.payload not in payloads:
+                continue
+            try:
+                await handler["func"](cb)
+                break
+            except Exception as e:
+                print("❌ Callback handler error:", e)

pymaxbot-0.1.0/max_bot/polling/polling.py

@@ -0,0 +1,37 @@
+import asyncio
+import httpx
+
+
+async def run_polling(bot, dispatcher):
+
+    offset = 0
+    print("🤖 Бот запущен, ожидаю сообщения...")
+
+    while True:
+        try:
+            updates = await bot.client.request(
+                "GET",
+                f"/updates?offset={offset}"
+            )
+
+            # Извлекаем marker и updates из ответа
+            if isinstance(updates, dict):
+                marker = updates.get("marker")
+                updates = updates.get("updates", [])
+                if marker:
+                    offset = marker
+
+            # Если пусто — пропускаем
+            if not updates:
+                await asyncio.sleep(1)
+                continue
+
+            for update in updates:
+                await dispatcher.process_update(update)
+
+        except httpx.ReadTimeout:
+            continue
+
+        except Exception as e:
+            print("Polling error:", e)
+            await asyncio.sleep(1)

pymaxbot-0.1.0/max_bot/types/callback.py

@@ -0,0 +1,29 @@
+from .message import Message
+
+
+class Callback:
+
+    def __init__(self, update: dict, bot):
+        self.bot = bot
+        cb_data = update.get("callback", {})
+
+        self.callback_id = cb_data.get("callback_id")
+        self.payload = cb_data.get("payload")
+
+        user = cb_data.get("user") or {}
+        self.user_id = user.get("user_id")
+
+        # message — сообщение с кнопками, sender в нём — бот, не пользователь.
+        # Для ответа используем reply(), который шлёт напрямую на user_id из callback.
+        raw_msg = update.get("message")
+        self.message = Message(raw_msg, bot) if raw_msg else None
+
+    async def answer(self, notification: str = None):
+        """Ответить на callback (снять состояние загрузки с кнопки)."""
+        await self.bot.answer_callback(self.callback_id, notification=notification)
+
+    async def reply(self, text: str, format=None, buttons=None):
+        """Отправить сообщение пользователю, нажавшему кнопку."""
+        return await self.bot.send_message(
+            chat_id=self.user_id, text=text, format=format, buttons=buttons
+        )

pymaxbot-0.1.0/max_bot/types/message.py

@@ -0,0 +1,48 @@
+class Message:
+
+    def __init__(self, data, bot):
+        self.data = data
+        self.bot = bot
+
+        body = data.get("body") or {}
+
+        self.text = body.get("text")
+        self.mid = body.get("mid")
+
+        sender = data.get("sender") or {}
+        self.chat_id = sender.get("user_id")
+
+        recipient = data.get("recipient") or {}
+        self.dialog_chat_id = recipient.get("chat_id")
+
+    async def answer(self, text: str, format=None, buttons=None):
+        if not self.chat_id:
+            return
+        return await self.bot.send_message(chat_id=self.chat_id, text=text, format=format, buttons=buttons)
+
+    async def send_document(self, file_path: str):
+        if not self.chat_id:
+            return
+        await self.bot.send_document(chat_id=self.chat_id, file_path=file_path)
+
+    async def send_documents(self, file_path: list[str]):
+        if not self.chat_id:
+            return
+        await self.bot.send_documents(chat_id=self.chat_id, file_path=file_path)
+
+    async def send_image(self, file_path: str, text: str = None):
+        if not self.chat_id:
+            return
+        return await self.bot.send_image(chat_id=self.chat_id, file_path=file_path, text=text)
+
+    async def send_images(self, file_paths: list[str], text: str = None):
+        if not self.chat_id:
+            return
+        await self.bot.send_images(chat_id=self.chat_id, file_paths=file_paths, text=text)
+
+    async def delete(self):
+        if self.mid:
+            try:
+                await self.bot.delete_message(self.mid)
+            except Exception:
+                pass

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

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: pymaxbot
+Version: 0.1.0
+Summary: Python SDK for MAX messenger bot API
+License: MIT License
+        
+        Copyright (c) 2026 Sergey Kurilenko
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/svkurick/max_bot
+Project-URL: Repository, https://github.com/svkurick/max_bot
+Project-URL: Issues, https://github.com/svkurick/max_bot/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Dynamic: license-file
+
+# max_bot

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

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+max_bot/__init__.py
+max_bot/bot.py
+max_bot/client.py
+max_bot/dispatcher/__init__.py
+max_bot/dispatcher/dispatcher.py
+max_bot/polling/__init__.py
+max_bot/polling/polling.py
+max_bot/types/__init__.py
+max_bot/types/callback.py
+max_bot/types/message.py
+pymaxbot.egg-info/PKG-INFO
+pymaxbot.egg-info/SOURCES.txt
+pymaxbot.egg-info/dependency_links.txt
+pymaxbot.egg-info/requires.txt
+pymaxbot.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+httpx

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

@@ -0,0 +1 @@
+max_bot

pymaxbot-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pymaxbot"
+version = "0.1.0"
+description = "Python SDK for MAX messenger bot API"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.9"
+dependencies = [
+    "httpx"
+]
+
+[project.urls]
+Homepage = "https://github.com/svkurick/max_bot"
+Repository = "https://github.com/svkurick/max_bot"
+Issues = "https://github.com/svkurick/max_bot/issues"

pymaxbot-0.1.0/setup.cfg

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