maxkit 2.13.0__py3-none-any.whl

aiomax/utils.py

@@ -0,0 +1,125 @@
+from inspect import signature
+from typing import Any, Callable, Literal
+
+import aiohttp
+
+from aiomax.types import Attachment
+
+from . import buttons, exceptions
+
+
+def get_message_body(
+    text: "str | None" = None,
+    format: "Literal['markdown', 'html'] | None" = None,
+    reply_to: "int | None" = None,
+    notify: bool = True,
+    keyboard: """list[list[buttons.Button]] \
+        | buttons.KeyboardBuilder \
+        | None""" = None,
+    attachments: "list[Attachment] | Attachment | None" = None,
+) -> dict:
+    """
+    Returns the body of the message as json.
+    """
+    body: dict[str, Any] = {"text": text, "format": format, "notify": notify}
+
+    # replying
+    if reply_to:
+        body["link"] = {"type": "reply", "mid": reply_to}
+
+    # keyboard
+    if keyboard:
+        if isinstance(keyboard, buttons.KeyboardBuilder):
+            keyboard = keyboard.to_list()
+
+        body["attachments"] = [
+            {
+                "type": "inline_keyboard",
+                "payload": {
+                    "buttons": [
+                        [
+                            i.to_json() if isinstance(i, buttons.Button) else i
+                            for i in row
+                        ]
+                        for row in keyboard
+                    ]
+                },
+            }
+        ]
+
+    if attachments:
+        if "attachments" not in body:
+            body["attachments"] = []
+
+        if not isinstance(attachments, list):
+            attachments = [attachments]
+
+        for at in attachments or []:
+            if not hasattr(at, "as_dict"):
+                raise exceptions.AiomaxException(
+                    "This attachment cannot be sent"
+                )
+            body["attachments"].append(at.as_dict())
+
+    if attachments == [] and "attachments" not in body:
+        body["attachments"] = []
+
+    return body
+
+
+def context_kwargs(func: Callable, **kwargs):
+    """
+    Returns only those kwargs, that callable accepts
+    """
+    params = list(signature(func).parameters.keys())
+
+    kwargs = {kw: arg for kw, arg in kwargs.items() if kw in params}
+
+    return kwargs
+
+
+async def get_exception(response: aiohttp.ClientResponse):
+    if response.status in range(200, 300):
+        return None
+
+    if response.content_type == "text/plain":
+        text = await response.text()
+        description = None
+
+    elif response.content_type == "application/json":
+        resp_json = await response.json()
+        # ``code`` may be absent in some error bodies; default to "" so the
+        # str checks below don't blow up with `None.startswith(...)`.
+        text = resp_json.get("code") or ""
+        description = resp_json.get("message")
+
+    else:
+        return Exception(f"Unknown error: {await response.read()}")
+
+    if text.startswith("Invalid access_token"):
+        return exceptions.InvalidToken()
+
+    if (
+        text == "attachment.not.ready"
+        or description == "Key: errors.process.attachment.video.not.processed"
+    ):
+        return exceptions.AttachmentNotReady()
+
+    if text == "chat.not.found":
+        return exceptions.ChatNotFound(description)
+
+    if description == "text: size must be between 0 and 4000":
+        return exceptions.IncorrectTextLength()
+
+    if text == "internal.error":
+        if description:
+            return exceptions.InternalError(description.split()[-1])
+        return exceptions.InternalError()
+
+    if text == "access.denied":
+        return exceptions.AccessDeniedException(description)
+
+    if text == "not.found":
+        return exceptions.NotFoundException(description)
+
+    return exceptions.UnknownErrorException(text, description)

maxkit-2.13.0.dist-info/METADATA

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: maxkit
+Version: 2.13.0
+Summary: Asynchronous framework for Max Bot API (maintained successor of aiomax)
+Author-email: mbutsk <mbutsk@icloud.com>, moontr3 <contact@moontr3.ru>
+Maintainer-email: Aleksandr Kovalko <gistrec@gmail.com>
+License-Expression: MIT
+Project-URL: Docs, https://github.com/gistrec/maxkit/wiki
+Project-URL: Source code, https://github.com/gistrec/maxkit
+Keywords: bot,api,asyncio,max,aiomax
+Classifier: Framework :: AsyncIO
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: aiohttp
+Requires-Dist: aiofiles
+Dynamic: license-file
+
+# maxkit
+
+Асинхронный фреймворк [Max](https://max.ru) Bot API.
+
+Поддерживаемый преемник [aiomax](https://github.com/dpnspn/aiomax)
+(оригинальный репозиторий заархивирован 14.07.2026). Модуль по-прежнему
+импортируется как `aiomax` — переход сводится к замене зависимости.
+
+## Преимущества
+
+- Полная асинхронность
+
+- Возможность разделения на роутеры
+
+- Эквиваленты всех функций доступных в Max Bot API
+
+- Встроенный конечный автомат (FSM)
+
+- Поддержка [PyPy](https://pypy.org/)

maxkit-2.13.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+aiomax/__init__.py,sha256=HtxYmM41JQIjCadaww8r0A7xjii95Rk6DLpsanrrM4M,222
+aiomax/bot.py,sha256=ffYnAMvXPqNEtYgYPaArn05dxL3PIYeaSFeFLEuR7B0,40099
+aiomax/buttons.py,sha256=l3R-caI5-czNNALciNFwCI3k8ZKvLmAYz6JopSJEEIc,8271
+aiomax/cache.py,sha256=8_LGaKxxjySj-0FNvcnH9Sy36-rvYJ5ryN0iUDKHq0E,802
+aiomax/exceptions.py,sha256=VIv-LD22o-yML74wk_mO9Kz-G77SkFyeiVxleiDTjdU,1679
+aiomax/filters.py,sha256=P8QKfrfgSEGEv75oq2rEeoChc0BqgaMWI4wTqferW7o,4547
+aiomax/fsm.py,sha256=5bo3FCWsg6fOPuBqi1DAG-deg2uzp3CHCM78qjJPaQs,2683
+aiomax/router.py,sha256=pLUfyais82J203GT2sJTI-yQ_Nv0vGd8-X7oVp-dLUU,10736
+aiomax/russian_trusted_root_ca.cer,sha256=CBmXdQLZrtIjSDD2_7kfgvQB02dMblHdGeFtiz2_DrQ,2056
+aiomax/types.py,sha256=7t2dDIaSU-rc5XbeNuPhCjtN2iWscH-uWbtGT2_hbsQ,47097
+aiomax/utils.py,sha256=OuGgY-a-LEdLOAi_vhhXcTwIbshDgMJn-cEY2LTqClg,3646
+maxkit-2.13.0.dist-info/licenses/LICENSE.md,sha256=pfBNYwt72grK5kTCDOkLvVmSeUF69GleBowMgzsENGQ,1106
+maxkit-2.13.0.dist-info/METADATA,sha256=cBicCns74VeE655KVV0ipsjTK61aVV-jjx6uIWC5eWo,1818
+maxkit-2.13.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+maxkit-2.13.0.dist-info/top_level.txt,sha256=7YZN0tu2cv5hbUyTdZQC5lGAx4lx49MTBUOj6KktlQQ,7
+maxkit-2.13.0.dist-info/RECORD,,

maxkit-2.13.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

maxkit-2.13.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,22 @@
+# MIT License
+
+Copyright (c) 2025 OAA DPNSPN
+Copyright (c) 2026 Aleksandr Kovalko
+
+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.

maxkit-2.13.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+aiomax