aiogram-webhook 3.0.1__tar.gz → 3.1.0__tar.gz

{aiogram_webhook-3.0.1 → aiogram_webhook-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aiogram-webhook
-Version: 3.0.1
+Version: 3.1.0
 Summary: A python library for integrating webhook support with multiple web frameworks in aiogram. Organizes bot operation via webhooks for both single and multi-bot setups.
 Keywords: aiogram,multibot,telegram,webhook,fastapi,aiohttp
 Author: m-xim
@@ -37,7 +37,7 @@ Provides-Extra: dev
 Provides-Extra: fastapi
 Description-Content-Type: text/markdown
 
-![PyPI version](docs/_assets/brand/banner.png)
+![Aiogram Webhook](docs/_assets/brand/banner.png)
 
 # aiogram-webhook
 [![PyPI version](https://img.shields.io/pypi/v/aiogram-webhook?color=blue)](https://pypi.org/project/aiogram-webhook)
@@ -45,11 +45,10 @@ Description-Content-Type: text/markdown
 [![Tests Status](https://github.com/m-xim/aiogram-webhook/actions/workflows/tests.yml/badge.svg)](https://github.com/m-xim/aiogram-webhook/actions)
 [![License](https://img.shields.io/github/license/m-xim/aiogram-webhook.svg)](/LICENSE)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/m-xim/aiogram-webhook)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
 
-`aiogram-webhook` is a modular Python library for webhook integration in aiogram.
-It supports single-bot and token-based multi-bot setups, with route building, optional request checks, and adapters for FastAPI and aiohttp.
+Handles the webhook layer for aiogram bots. Registers the endpoint, calls Telegram `setWebhook`, verifies incoming requests, and manages engine lifecycle. Works with FastAPI and aiohttp.
 
 ## Install
 
@@ -59,35 +58,9 @@ pip install "aiogram-webhook[fastapi]"
 pip install "aiogram-webhook[aiohttp]"
 ```
 
-## Quick Start
-
-```python
-from aiogram import Bot, Dispatcher
-from fastapi import FastAPI
-
-from aiogram_webhook import FastAPIAdapter, SingleBotEngine
-from aiogram_webhook.route import Route
-
-dispatcher = Dispatcher()
-bot = Bot("BOT_TOKEN")
-
-engine = SingleBotEngine(
-    dispatcher,
-    bot,
-    web=FastAPIAdapter(),
-    route=Route(base_url="https://example.com", path="/webhook"),
-)
-
-app = FastAPI()
-engine.register(app)
-```
-
-Call `await engine.set_webhook()` during your application startup to register the public webhook URL in Telegram.
-For production, pass `security=Security(...)` to verify Telegram requests.
-
 ## Documentation
 
-The full documentation is in [`docs`](https://aiogram-webhook.m-xim.ru). It covers installation, FastAPI and aiohttp setup, routing, security, lifecycle behavior, and the public API.
+The full documentation is at [aiogram-webhook.m-xim.ru](https://aiogram-webhook.m-xim.ru). It covers installation, setup, routing, security, lifecycle behavior, and the public API.
 
 ## Contributing
 

{aiogram_webhook-3.0.1 → aiogram_webhook-3.1.0}/README.md

@@ -1,4 +1,4 @@
-![PyPI version](docs/_assets/brand/banner.png)
+![Aiogram Webhook](docs/_assets/brand/banner.png)
 
 # aiogram-webhook
 [![PyPI version](https://img.shields.io/pypi/v/aiogram-webhook?color=blue)](https://pypi.org/project/aiogram-webhook)
@@ -6,11 +6,10 @@
 [![Tests Status](https://github.com/m-xim/aiogram-webhook/actions/workflows/tests.yml/badge.svg)](https://github.com/m-xim/aiogram-webhook/actions)
 [![License](https://img.shields.io/github/license/m-xim/aiogram-webhook.svg)](/LICENSE)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/m-xim/aiogram-webhook)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
 
-`aiogram-webhook` is a modular Python library for webhook integration in aiogram.
-It supports single-bot and token-based multi-bot setups, with route building, optional request checks, and adapters for FastAPI and aiohttp.
+Handles the webhook layer for aiogram bots. Registers the endpoint, calls Telegram `setWebhook`, verifies incoming requests, and manages engine lifecycle. Works with FastAPI and aiohttp.
 
 ## Install
 
@@ -20,35 +19,9 @@ pip install "aiogram-webhook[fastapi]"
 pip install "aiogram-webhook[aiohttp]"
 ```
 
-## Quick Start
-
-```python
-from aiogram import Bot, Dispatcher
-from fastapi import FastAPI
-
-from aiogram_webhook import FastAPIAdapter, SingleBotEngine
-from aiogram_webhook.route import Route
-
-dispatcher = Dispatcher()
-bot = Bot("BOT_TOKEN")
-
-engine = SingleBotEngine(
-    dispatcher,
-    bot,
-    web=FastAPIAdapter(),
-    route=Route(base_url="https://example.com", path="/webhook"),
-)
-
-app = FastAPI()
-engine.register(app)
-```
-
-Call `await engine.set_webhook()` during your application startup to register the public webhook URL in Telegram.
-For production, pass `security=Security(...)` to verify Telegram requests.
-
 ## Documentation
 
-The full documentation is in [`docs`](https://aiogram-webhook.m-xim.ru). It covers installation, FastAPI and aiohttp setup, routing, security, lifecycle behavior, and the public API.
+The full documentation is at [aiogram-webhook.m-xim.ru](https://aiogram-webhook.m-xim.ru). It covers installation, setup, routing, security, lifecycle behavior, and the public API.
 
 ## Contributing
 

{aiogram_webhook-3.0.1 → aiogram_webhook-3.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aiogram-webhook"
-version = "3.0.1"
+version = "3.1.0"
 description = "A python library for integrating webhook support with multiple web frameworks in aiogram. Organizes bot operation via webhooks for both single and multi-bot setups."
 readme = "README.md"
 license = { text = "MIT" }
@@ -59,6 +59,11 @@ dev = [
 requires = ["uv_build<0.12"]
 build-backend = "uv_build"
 
+[tool.pytest.ini_options]
+filterwarnings = [
+    "ignore:Security is not configured:UserWarning",
+]
+
 [tool.uv]
 package = true
 

{aiogram_webhook-3.0.1 → aiogram_webhook-3.1.0}/src/aiogram_webhook/engines/base.py

@@ -1,7 +1,5 @@
 import warnings
 from abc import ABC, abstractmethod
-from collections.abc import AsyncGenerator
-from contextlib import asynccontextmanager
 from typing import Any, Generic, TypeVar
 
 from aiogram import Bot, Dispatcher
@@ -111,14 +109,6 @@ class BaseWebhookEngine(ABC, Generic[AppT, RawRequestT, FrameworkResponseT]):
         self._is_shutting_down = True
         await self._on_shutdown(app, *args, **kwargs)
 
-    @asynccontextmanager
-    async def lifespan(self, app: AppT) -> AsyncGenerator[None, Any]:
-        try:
-            await self.on_startup(app=app)
-            yield
-        finally:
-            await self.on_shutdown(app=app)
-
     @abstractmethod
     async def _on_startup(self, app: AppT, *args: Any, **kwargs: Any) -> None:
         raise NotImplementedError

{aiogram_webhook-3.0.1 → aiogram_webhook-3.1.0}/src/aiogram_webhook/web/fastapi.py

@@ -1,8 +1,9 @@
 from collections.abc import Mapping
+from contextlib import asynccontextmanager
 from typing import Any
 
 from aiohttp import Payload
-from fastapi import FastAPI, Request, Response
+from fastapi import APIRouter, FastAPI, Request, Response
 from fastapi.responses import JSONResponse
 from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy
 
@@ -64,13 +65,23 @@ class FastAPIAdapter(WebAdapter[FastAPI, Request, Response]):
         path: str,
         handler: WebHandler[Request, Response],
         *,
-        on_startup: LifecycleCallback,  # noqa: ARG002
-        on_shutdown: LifecycleCallback,  # noqa: ARG002
+        on_startup: LifecycleCallback,
+        on_shutdown: LifecycleCallback,
     ) -> None:
         async def endpoint(request: Request) -> Response:
             return await handler(self.bind_request(request))
 
-        app.add_api_route(path=path, endpoint=endpoint, methods=["POST"])
+        @asynccontextmanager
+        async def lifespan(_router: APIRouter):
+            try:
+                await on_startup(app)
+                yield
+            finally:
+                await on_shutdown(app)
+
+        router = APIRouter(lifespan=lifespan)
+        router.add_api_route(path=path, endpoint=endpoint, methods=["POST"])
+        app.include_router(router)
 
     def json_response(
         self, status_code: int, data: dict[str, str] | None = None, headers: Mapping[str, str] | None = None