lo-aiogram 0.2.0__tar.gz

lo_aiogram-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LO contributors
+
+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.

lo_aiogram-0.2.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: lo-aiogram
+Version: 0.2.0
+Summary: LO compatibility session for aiogram 3
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiogram<4,>=3.31
+Dynamic: license-file
+
+# lo-aiogram
+
+LO HTTP session for aiogram 3.31–3.x. The session serializes aiogram methods for LO and preserves requested operations and errors.
+
+```python
+import os
+from aiogram import Bot
+from lo_aiogram import LoAiohttpSession
+
+bot = Bot(os.environ["LO_BOT_TOKEN"], session=LoAiohttpSession())
+```
+
+Close the session when the bot stops. Use HTTPS for custom base_url. Tests may explicitly allow loopback HTTP. Single files and thumbnails use parameter-named parts; album files use attach:// references.
+
+Unsupported fields, mixed albums, disabled video uploads and unimplemented methods fail explicitly. The adapter never strips fields, changes a video into a document, splits an album, retries a mutation or returns success for an unsupported operation. Existing Telegram handlers must be adapted to the documented LO contract. Read installation capabilities explicitly through getMe when needed.
+
+Structured server failure parameters are exposed as lo_reason and lo_parameter on aiogram exceptions. Non-JSON HTTP 5xx responses become TelegramServerError without exposing HTML diagnostics. Secretary requests with business_connection_id are rejected locally; use the native Bot SDK with LO consent context.
+
+The packaged contract describes accepted requests. Tests run real aiogram clients against the strict LO emulator; the emulator does not reproduce production storage, authentication, transcoding or permissions.

lo_aiogram-0.2.0/README.md

@@ -0,0 +1,19 @@
+# lo-aiogram
+
+LO HTTP session for aiogram 3.31–3.x. The session serializes aiogram methods for LO and preserves requested operations and errors.
+
+```python
+import os
+from aiogram import Bot
+from lo_aiogram import LoAiohttpSession
+
+bot = Bot(os.environ["LO_BOT_TOKEN"], session=LoAiohttpSession())
+```
+
+Close the session when the bot stops. Use HTTPS for custom base_url. Tests may explicitly allow loopback HTTP. Single files and thumbnails use parameter-named parts; album files use attach:// references.
+
+Unsupported fields, mixed albums, disabled video uploads and unimplemented methods fail explicitly. The adapter never strips fields, changes a video into a document, splits an album, retries a mutation or returns success for an unsupported operation. Existing Telegram handlers must be adapted to the documented LO contract. Read installation capabilities explicitly through getMe when needed.
+
+Structured server failure parameters are exposed as lo_reason and lo_parameter on aiogram exceptions. Non-JSON HTTP 5xx responses become TelegramServerError without exposing HTML diagnostics. Secretary requests with business_connection_id are rejected locally; use the native Bot SDK with LO consent context.
+
+The packaged contract describes accepted requests. Tests run real aiogram clients against the strict LO emulator; the emulator does not reproduce production storage, authentication, transcoding or permissions.

lo_aiogram-0.2.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lo-aiogram"
+version = "0.2.0"
+description = "LO compatibility session for aiogram 3"
+requires-python = ">=3.11"
+dependencies = ["aiogram>=3.31,<4"]
+license = "MIT"
+readme = "README.md"
+license-files = ["LICENSE"]
+
+[tool.setuptools.package-data]
+lo_aiogram = ["contract.json"]

lo_aiogram-0.2.0/setup.cfg

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

lo_aiogram-0.2.0/src/lo_aiogram/__init__.py

@@ -0,0 +1,86 @@
+"""LO HTTP serialization for aiogram, without automatic request adaptation."""
+
+import json
+from urllib.parse import urlsplit
+
+from aiogram.client.session.aiohttp import AiohttpSession
+from aiogram.client.telegram import TelegramAPIServer
+from aiogram.exceptions import TelegramBadRequest, TelegramServerError
+from aiogram.types import InputFile
+from aiohttp import FormData
+
+__all__ = ["LoAiohttpSession"]
+
+
+class LoAiohttpSession(AiohttpSession):
+    """Send the requested operation once, with parameter-named upload parts."""
+
+    def __init__(self, *, base_url="https://api.lo.ink", allow_insecure_loopback=False, **kwargs):
+        parsed = urlsplit(base_url)
+        if (
+            not parsed.hostname
+            or base_url.strip() != base_url
+            or parsed.username
+            or parsed.password
+            or parsed.query
+            or parsed.fragment
+            or parsed.scheme != "https"
+            and not (
+                allow_insecure_loopback
+                and parsed.scheme == "http"
+                and parsed.hostname in ("localhost", "127.0.0.1", "::1")
+            )
+        ):
+            raise ValueError("Use HTTPS or explicitly enabled loopback HTTP")
+        super().__init__(api=TelegramAPIServer.from_base(base_url.rstrip("/")), **kwargs)
+
+    def build_form_data(self, bot, method):
+        if getattr(method, "business_connection_id", None) is not None:
+            raise ValueError("LO secretary operations require native consent context")
+        form = FormData(quote_fields=False)
+        attachments: dict[str, InputFile] = {}
+        for key, original in method.model_dump(warnings=False).items():
+            original = getattr(method, key, original)
+            if isinstance(original, InputFile):
+                form.add_field(key, original.read(bot), filename=original.filename or key)
+            else:
+                value = self.prepare_value(original, bot=bot, files=attachments)
+                if value is not None and value != "":
+                    form.add_field(key, value)
+        for key, value in attachments.items():
+            form.add_field(key, value.read(bot), filename=value.filename or key)
+        return form
+
+    def check_response(self, bot, method, status_code, content):
+        if status_code >= 500:
+            try:
+                parsed = json.loads(content)
+            except (ValueError, TypeError):
+                parsed = None
+            if not isinstance(parsed, dict) or not isinstance(parsed.get("ok"), bool):
+                raise TelegramServerError(
+                    method=method, message="LO Bot API is temporarily unavailable"
+                )
+        try:
+            return super().check_response(bot, method, status_code, content)
+        except (TelegramBadRequest, TelegramServerError) as error:
+            try:
+                parameters = json.loads(content).get("parameters", {})
+            except (ValueError, TypeError, AttributeError):
+                parameters = {}
+            if isinstance(parameters, dict):
+                metadata = {}
+                reason = parameters.get("reason")
+                parameter = parameters.get("parameter")
+                if reason in (
+                    "unsupported_parameter",
+                    "upload_only",
+                    "feature_disabled",
+                    "method_not_implemented",
+                ):
+                    metadata["lo_reason"] = reason
+                if isinstance(parameter, str) and parameter.isidentifier():
+                    metadata["lo_parameter"] = parameter
+                for attribute, value in metadata.items():
+                    setattr(error, attribute, value)
+            raise