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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aiogram-webhook
-Version: 3.0.0
+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.0 → 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.0 → aiogram_webhook-3.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aiogram-webhook"
-version = "3.0.0"
+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.0 → aiogram_webhook-3.1.0}/src/aiogram_webhook/engines/base.py

@@ -2,7 +2,7 @@ import warnings
 from abc import ABC, abstractmethod
 from typing import Any, Generic, TypeVar
 
-from aiogram import Bot
+from aiogram import Bot, Dispatcher
 from aiogram.methods import TelegramMethod
 
 from aiogram_webhook.engines.errors import (
@@ -31,9 +31,7 @@ FrameworkResponseT = TypeVar("FrameworkResponseT")
 class BaseWebhookEngine(ABC, Generic[AppT, RawRequestT, FrameworkResponseT]):
     def __init__(
         self,
-        dispatcher,
-        /,
-        *,
+        dispatcher: Dispatcher,
         web: WebAdapter[AppT, RawRequestT, FrameworkResponseT],
         route: Route,
         security: Security | None = None,

{aiogram_webhook-3.0.0 → aiogram_webhook-3.1.0}/src/aiogram_webhook/engines/multi.py

@@ -21,8 +21,6 @@ class BaseMultiBotEngine(
     def __init__(
         self,
         dispatcher,
-        /,
-        *,
         web: WebAdapter[AppT, RawRequestT, FrameworkResponseT],
         route: Route,
         security: Security | None = None,
@@ -34,7 +32,7 @@ class BaseMultiBotEngine(
         self._bots: dict[int, Bot] = {}
         self.webhook_config = webhook_config or WebhookConfig()
         super().__init__(
-            dispatcher,
+            dispatcher=dispatcher,
             web=web,
             route=route,
             security=security,

{aiogram_webhook-3.0.0 → aiogram_webhook-3.1.0}/src/aiogram_webhook/engines/single.py

@@ -19,8 +19,6 @@ class SingleBotEngine(
         self,
         dispatcher,
         bot: Bot,
-        /,
-        *,
         web: WebAdapter[AppT, RawRequestT, FrameworkResponseT],
         route: Route,
         security=None,
@@ -31,7 +29,7 @@ class SingleBotEngine(
         self._task_tracker = TaskTracker()
 
         super().__init__(
-            dispatcher,
+            dispatcher=dispatcher,
             web=web,
             route=route,
             security=security,

{aiogram_webhook-3.0.0 → aiogram_webhook-3.1.0}/src/aiogram_webhook/engines/token.py

@@ -24,8 +24,6 @@ class TokenEngine(
     def __init__(
         self,
         dispatcher,
-        /,
-        *,
         web: WebAdapter[AppT, RawRequestT, FrameworkResponseT],
         route: Route,
         security=None,
@@ -35,7 +33,7 @@ class TokenEngine(
         shutdown_timeout: float = 10.0,
     ) -> None:
         super().__init__(
-            dispatcher,
+            dispatcher=dispatcher,
             web=web,
             route=route,
             security=security,

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

@@ -1,4 +1,4 @@
-from collections.abc import AsyncIterator, Mapping
+from collections.abc import Mapping
 from contextlib import asynccontextmanager
 from typing import Any
 
@@ -6,7 +6,6 @@ from aiohttp import Payload
 from fastapi import APIRouter, FastAPI, Request, Response
 from fastapi.responses import JSONResponse
 from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy
-from starlette.types import Lifespan
 
 from aiogram_webhook.web._starlette import AiohttpPayloadResponse
 from aiogram_webhook.web.base import (
@@ -60,18 +59,6 @@ class FastAPIAdapter(WebAdapter[FastAPI, Request, Response]):
     def bind_request(self, request: Request) -> WebRequest[Request]:
         return FastAPIWebRequest(request)
 
-    @staticmethod
-    def _build_lifespan(on_startup: LifecycleCallback, on_shutdown: LifecycleCallback) -> Lifespan[FastAPI]:
-        @asynccontextmanager
-        async def lifespan(app: FastAPI) -> AsyncIterator[None]:
-            await on_startup(app)
-            try:
-                yield
-            finally:
-                await on_shutdown(app)
-
-        return lifespan
-
     def register(
         self,
         app: FastAPI,
@@ -84,7 +71,15 @@ class FastAPIAdapter(WebAdapter[FastAPI, Request, Response]):
         async def endpoint(request: Request) -> Response:
             return await handler(self.bind_request(request))
 
-        router = APIRouter(lifespan=self._build_lifespan(on_startup, on_shutdown))
+        @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)