anyquart 0.2.1__tar.gz → 0.3.0__tar.gz

{anyquart-0.2.1 → anyquart-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: anyquart
-Version: 0.2.1
+Version: 0.3.0
 Summary: A fork of Quart that uses AnyIO
 Author-email: pgjones <philip.graham.jones@googlemail.com>, NIYONSHUTI Emmanuel <emmanuelniyonshuti13@gmail.com>
 Maintainer-email: NIYONSHUTI Emmanuel <emmanuelniyonshuti13@gmail.com>
@@ -27,18 +27,20 @@ Requires-Dist: anyio>=4.14.0,<5
 Requires-Dist: blinker>=1.6
 Requires-Dist: click>=8.0
 Requires-Dist: flask>=3.0
-Requires-Dist: anycorn>=0.11.2
 Requires-Dist: importlib-metadata; python_version < '3.13'
 Requires-Dist: itsdangerous
 Requires-Dist: jinja2
 Requires-Dist: markupsafe
 Requires-Dist: typing-extensions; python_version < '3.13'
 Requires-Dist: werkzeug>=3.0
+Requires-Dist: anycorn>=0.11.2 ; extra == "anycorn"
 Requires-Dist: python-dotenv ; extra == "dotenv"
 Project-URL: Documentation, https://quart.palletsprojects.com
 Project-URL: Donate, https://palletsprojects.com/donate
 Project-URL: Source, https://github.com/EmmanuelNiyonshuti/anyquart
+Provides-Extra: anycorn
 Provides-Extra: dotenv
+Import-Name: anyquart
 
 # AnyQuart
 
@@ -55,11 +57,35 @@ AnyQuart is [Quart](https://github.com/pallets/quart) running on [AnyIO](https:/
 ## Differences from Quart
 `AnyQuart` and `Quart` are essentially the same thing. The only difference is the name and the internals(Asyncio replaced with AnyIO). This also means the testing setup changes, which is explained in the [Testing](#testing) section below.
 
-- Works with both asyncio and Trio code via AnyIO, giving you structured concurrency out of the box.
-- Uses [Anycorn](https://github.com/davidbrochart/anycorn) instead of Hypercorn as the development server.
-- [aiofiles](https://github.com/Tinche/aiofiles) dropped, AnyIO's file I/O is used instead.
-- [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) replaced by [AnyIO pytest plugin](https://anyio.readthedocs.io/en/stable/testing.html).
-- Runs on Python 3.10+ .
+1. Works with both asyncio and Trio code via AnyIO, giving you structured concurrency out of the box.
+2. [aiofiles](https://github.com/Tinche/aiofiles) dropped, AnyIO's file I/O is used instead.
+3. [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) replaced by [AnyIO pytest plugin](https://anyio.readthedocs.io/en/stable/testing.html).
+4. As of 0.3.0, [Anycorn](https://github.com/davidbrochart/anycorn) is an optional dependency for the development server, while Quart installs [Hypercorn](https://hypercorn.readthedocs.io) as a required dependency for the same purpose.
+5. As of 0.3.0, AnyQuart provides a Request-scoped dependency injection for route handlers.
+Request handlers may mark parameters with :class:`Needs` to resolve a request-scoped value.
+e.g:
+    ```python
+    from anyquart import Needs
+
+    async def get_db() -> AsyncGenerator[AsyncSession, None]:
+        async with async_session() as session:
+            yield session
+
+    @app.route("/users")
+    async def get_users(db: AsyncSession = Needs(get_db)) -> None:
+        ...
+
+    # Or:
+    DBSession = Annotated[AsyncSession, Needs(get_db)]
+
+    @app.route("/users")
+    async def get_users(db: DBSession) -> None:
+        ...
+
+    # Tests can use `app.dependency_overrides` dictionary to replace route handler's
+    # dependency with test dependency
+    ```
+6. Runs on Python 3.10+
 
 ## Usage
 You will have to replace `quart` with `anyquart` and `Quart` with `AnyQuart`.
@@ -91,11 +117,16 @@ async def ws():
         await websocket.send("hello")
         await websocket.send_json({"hello": "world"})
 ```
-
+Install an ASGI web server, pick one from [this list](https://asgi.readthedocs.io/en/latest/implementations.html), or install anyquart with Anycorn directly:
+```bash
+$ uv add anyquart[anycorn]
 ```
-$ anyquart run
- * Running on http://127.0.0.1:5000 (CTRL + C to quit)
+run the application:
+```bash
+$ anycorn app:app
+ * [2026-08-01 11:49:46 +0200] [30809] [INFO] Running on http://127.0.0.1:8000 (CTRL + C to quit)
 ```
+The built-in `anyquart run` command is only available on anyquart <= 0.2.1 — from 0.3.0 onward, run the ASGI server directly as shown above.
 
 # Testing
 Pytest requires a plugin to run asynchronous test functions and fixtures.

{anyquart-0.2.1 → anyquart-0.3.0}/README.md

@@ -13,11 +13,35 @@ AnyQuart is [Quart](https://github.com/pallets/quart) running on [AnyIO](https:/
 ## Differences from Quart
 `AnyQuart` and `Quart` are essentially the same thing. The only difference is the name and the internals(Asyncio replaced with AnyIO). This also means the testing setup changes, which is explained in the [Testing](#testing) section below.
 
-- Works with both asyncio and Trio code via AnyIO, giving you structured concurrency out of the box.
-- Uses [Anycorn](https://github.com/davidbrochart/anycorn) instead of Hypercorn as the development server.
-- [aiofiles](https://github.com/Tinche/aiofiles) dropped, AnyIO's file I/O is used instead.
-- [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) replaced by [AnyIO pytest plugin](https://anyio.readthedocs.io/en/stable/testing.html).
-- Runs on Python 3.10+ .
+1. Works with both asyncio and Trio code via AnyIO, giving you structured concurrency out of the box.
+2. [aiofiles](https://github.com/Tinche/aiofiles) dropped, AnyIO's file I/O is used instead.
+3. [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) replaced by [AnyIO pytest plugin](https://anyio.readthedocs.io/en/stable/testing.html).
+4. As of 0.3.0, [Anycorn](https://github.com/davidbrochart/anycorn) is an optional dependency for the development server, while Quart installs [Hypercorn](https://hypercorn.readthedocs.io) as a required dependency for the same purpose.
+5. As of 0.3.0, AnyQuart provides a Request-scoped dependency injection for route handlers.
+Request handlers may mark parameters with :class:`Needs` to resolve a request-scoped value.
+e.g:
+    ```python
+    from anyquart import Needs
+
+    async def get_db() -> AsyncGenerator[AsyncSession, None]:
+        async with async_session() as session:
+            yield session
+
+    @app.route("/users")
+    async def get_users(db: AsyncSession = Needs(get_db)) -> None:
+        ...
+
+    # Or:
+    DBSession = Annotated[AsyncSession, Needs(get_db)]
+
+    @app.route("/users")
+    async def get_users(db: DBSession) -> None:
+        ...
+
+    # Tests can use `app.dependency_overrides` dictionary to replace route handler's
+    # dependency with test dependency
+    ```
+6. Runs on Python 3.10+
 
 ## Usage
 You will have to replace `quart` with `anyquart` and `Quart` with `AnyQuart`.
@@ -49,11 +73,16 @@ async def ws():
         await websocket.send("hello")
         await websocket.send_json({"hello": "world"})
 ```
-
+Install an ASGI web server, pick one from [this list](https://asgi.readthedocs.io/en/latest/implementations.html), or install anyquart with Anycorn directly:
+```bash
+$ uv add anyquart[anycorn]
 ```
-$ anyquart run
- * Running on http://127.0.0.1:5000 (CTRL + C to quit)
+run the application:
+```bash
+$ anycorn app:app
+ * [2026-08-01 11:49:46 +0200] [30809] [INFO] Running on http://127.0.0.1:8000 (CTRL + C to quit)
 ```
+The built-in `anyquart run` command is only available on anyquart <= 0.2.1 — from 0.3.0 onward, run the ASGI server directly as shown above.
 
 # Testing
 Pytest requires a plugin to run asynchronous test functions and fixtures.

{anyquart-0.2.1 → anyquart-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "anyquart"
-version = "0.2.1"
+version = "0.3.0"
 description = "A fork of Quart that uses AnyIO"
 readme = "README.md"
 license = "MIT"
@@ -37,7 +37,6 @@ dependencies = [
     "blinker>=1.6",
     "click>=8.0",
     "flask>=3.0",
-    "anycorn>=0.11.2",
     "importlib-metadata; python_version < '3.13'",
     "itsdangerous",
     "jinja2",
@@ -53,6 +52,7 @@ Source = "https://github.com/EmmanuelNiyonshuti/anyquart"
 
 [project.optional-dependencies]
 dotenv = ["python-dotenv"]
+anycorn = ["anycorn>=0.11.2"]
 
 [project.scripts]
 anyquart = "anyquart.cli:main"
@@ -78,6 +78,7 @@ tests = [
     "pytest-cov",
     "pytest-sugar",
     "python-dotenv",
+    "anycorn>=0.11.2" # need in typing ci job
 ]
 typing = [
     "mypy",

{anyquart-0.2.1 → anyquart-0.3.0}/src/anyquart/__init__.py

@@ -13,6 +13,7 @@ from .ctx import copy_current_websocket_context as copy_current_websocket_contex
 from .ctx import has_app_context as has_app_context
 from .ctx import has_request_context as has_request_context
 from .ctx import has_websocket_context as has_websocket_context
+from .di import Needs as Needs
 from .globals import current_app as current_app
 from .globals import g as g
 from .globals import request as request

{anyquart-0.2.1 → anyquart-0.3.0}/src/anyquart/app.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import asyncio
 import os
 import signal
 import sys
@@ -12,7 +11,7 @@ from collections.abc import Callable
 from contextlib import AbstractAsyncContextManager
 from datetime import timedelta
 from inspect import isasyncgen
-from inspect import iscoroutinefunction as _inspect_iscoroutinefunction
+from inspect import iscoroutinefunction
 from inspect import isgenerator
 from types import TracebackType
 from typing import Any
@@ -25,11 +24,6 @@ from typing import TypeVar
 from urllib.parse import quote
 
 import anyio
-from anycorn import serve
-from anycorn.config import Config as HyperConfig
-from anycorn.typing import ASGIReceiveCallable
-from anycorn.typing import ASGISendCallable
-from anycorn.typing import Scope
 from anyio import AsyncFile
 from anyio import create_task_group
 from anyio import current_time
@@ -52,6 +46,10 @@ from werkzeug.routing import MapAdapter
 from werkzeug.routing import RoutingException
 from werkzeug.wrappers import Response as WerkzeugResponse
 
+from anyquart.typing import ASGIReceiveCallable
+from anyquart.typing import ASGISendCallable
+from anyquart.typing import Scope
+
 from .asgi import ASGIHTTPConnection
 from .asgi import ASGILifespan
 from .asgi import ASGIWebsocketConnection
@@ -63,6 +61,8 @@ from .ctx import has_request_context
 from .ctx import has_websocket_context
 from .ctx import RequestContext
 from .ctx import WebsocketContext
+from .di import check_name_conflicts
+from .di import invoke_with_di
 from .globals import _cv_app
 from .globals import _cv_request
 from .globals import _cv_websocket
@@ -127,15 +127,6 @@ from .wrappers import Request
 from .wrappers import Response
 from .wrappers import Websocket
 
-# Python 3.14 deprecated asyncio.iscoroutinefunction, but suggested
-# inspect.iscoroutinefunction does not work correctly in some Python
-# versions before 3.12.
-# See https://github.com/python/cpython/issues/122858#issuecomment-2466239748
-if sys.version_info >= (3, 12):
-    iscoroutinefunction = _inspect_iscoroutinefunction
-else:
-    iscoroutinefunction = asyncio.iscoroutinefunction
-
 AppOrBlueprintKey = str | None  # The App key is None, whereas blueprints are named
 T_after_serving = TypeVar("T_after_serving", bound=AfterServingCallable)
 T_after_websocket = TypeVar("T_after_websocket", bound=AfterWebsocketCallable)
@@ -345,6 +336,10 @@ class AnyQuart(App):
         self.cli = AppGroup()
         self.cli.name = self.name
 
+        # overrides route handler's dependencies, useful for tests for replacing
+        # expensive dependency
+        self.dependency_overrides: dict[Callable[..., Any], Callable[..., Any]] = {}
+
         if self.has_static_folder:
             assert bool(static_host) == host_matching, (
                 "Invalid static_host/host_matching combination"
@@ -573,6 +568,42 @@ class AnyQuart(App):
             return self.url_map.bind(self.config["SERVER_NAME"], url_scheme=scheme)
         return None
 
+    @setupmethod
+    def add_url_rule(
+        self,
+        rule: str,
+        endpoint: str | None = None,
+        view_func: Callable[..., Any] | None = None,
+        provide_automatic_options: bool | None = None,
+        **options: Any,
+    ) -> None:
+        """Register a rule for routing incoming requests and building URLs.
+
+        In addition to the default behaviour this raises
+        :exc:`ValueError` at registration time if any parameter of the view
+        function is marked as a :class:`~anyquart.di.Needs` dependency but its
+        name also appears as a URL rule converter in ``rule``, since the two
+        sources would otherwise clobber one another when dispatching.
+
+        Arguments:
+            rule: The URL rule string.
+            endpoint: The endpoint name to associate with the rule
+                and view function.
+            view_func: The view function to associate with the
+                endpoint name.
+            provide_automatic_options: Add the ``OPTIONS`` method and
+                respond to ``OPTIONS`` requests automatically.
+        """
+        if view_func is not None:
+            check_name_conflicts(view_func, rule, options.get("defaults"))
+        super().add_url_rule(
+            rule,
+            endpoint,
+            view_func,
+            provide_automatic_options,
+            **options,
+        )
+
     def websocket(
         self,
         rule: str,
@@ -785,10 +816,9 @@ class AnyQuart(App):
         app_import_path: str | None = None,
         **kwargs: Any,
     ) -> None:
-        """Run this application.
-
-        This is best used for development only, see Hypercorn for
-        production servers.
+        """Run this application. This is best used for development only,
+        See from the list: https://asgi.readthedocs.io/en/latest/implementations.html
+        for production servers.
 
         Arguments:
             host: Hostname to listen on. By default this is loopback
@@ -800,6 +830,13 @@ class AnyQuart(App):
             certfile: Path to the SSL certificate file.
             keyfile: Path to the SSL key file.
         """
+        try:
+            from anycorn.config import Config as HyperConfig
+        except ImportError:
+            raise RuntimeError("""Install ASGI webserver to run in development mode
+                                  e.g: `uv add anyquart[anycorn]
+                                or choose one from this list https://asgi.readthedocs.io/en/latest/implementations.html
+                                """) from None
         if kwargs:
             warnings.warn(
                 f"Additional arguments, {','.join(kwargs.keys())}, are not supported.\n"
@@ -830,25 +867,6 @@ class AnyQuart(App):
         scheme = "https" if certfile is not None and keyfile is not None else "http"
         print(f" * Running on {scheme}://{host}:{port} (CTRL + C to quit)")
 
-        if use_reloader:
-            from anycorn.run import run as anycorn_run
-
-            config = self._build_config(host, port, debug, ca_certs, certfile, keyfile)
-            config.use_reloader = True
-            config.application_path = app_import_path
-            anycorn_run(config)
-        else:
-            anyio.run(self._run_serve, host, port, debug, ca_certs, certfile, keyfile)
-
-    def _build_config(
-        self,
-        host: str,
-        port: int,
-        debug: bool | None,
-        ca_certs: str | None,
-        certfile: str | None,
-        keyfile: str | None,
-    ) -> HyperConfig:
         config = HyperConfig()
         config.access_log_format = "%(h)s %(r)s %(s)s %(b)s %(D)s"
         config.accesslog = "-"
@@ -860,32 +878,20 @@ class AnyQuart(App):
             config.debug = debug
         config.errorlog = config.accesslog
         config.keyfile = keyfile
-        return config
 
-    async def _run_serve(
-        self,
-        host: str = "127.0.0.1",
-        port: int = 5000,
-        debug: bool = False,
-        ca_certs: str | None = None,
-        certfile: str | None = None,
-        keyfile: str | None = None,
-    ) -> None:
-        """runs this application.
+        if use_reloader:
+            # run directly with anycorn when in reload mode.
+            from anycorn.run import run as anycorn_run
 
-        This is best used for development only, see Hypercorn for
-        production servers.
+            config.use_reloader = True
+            config.application_path = app_import_path
+            anycorn_run(config)
+        else:
+            anyio.run(self._run_serve, config)
 
-        Arguments:
-            host: Hostname to listen on. By default this is loopback
-                only, use 0.0.0.0 to have the server listen externally.
-            port: Port number to listen on.
-            debug: If set enable (or disable) debug mode and debug output.
-            ca_certs: Path to the SSL CA certificate file.
-            certfile: Path to the SSL certificate file.
-            keyfile: Path to the SSL key file.
+    async def _run_serve(self, config) -> None:  # type: ignore
+        from anycorn import serve
 
-        """
         shutdown_event = Event()
 
         async def watch_signals() -> None:
@@ -894,10 +900,13 @@ class AnyQuart(App):
                     shutdown_event.set()
                     return
 
-        config = self._build_config(host, port, debug, ca_certs, certfile, keyfile)
         async with create_task_group() as tg:
             tg.start_soon(watch_signals)
-            await serve(self, config, shutdown_trigger=shutdown_event.wait)
+            await serve(
+                self,  # type: ignore[arg-type]
+                config,
+                shutdown_trigger=shutdown_event.wait,
+            )
             tg.cancel_scope.cancel()
 
     def test_client(
@@ -1574,7 +1583,7 @@ class AnyQuart(App):
             return await self.make_default_options_response()
 
         handler = self.view_functions[request_.url_rule.endpoint]
-        return await self.ensure_async(handler)(**request_.view_args)  # type: ignore[return-value]
+        return await invoke_with_di(self, handler, request_.view_args)
 
     async def dispatch_websocket(
         self, websocket_context: WebsocketContext | None = None

{anyquart-0.2.1 → anyquart-0.3.0}/src/anyquart/asgi.py

@@ -7,21 +7,6 @@ from typing import cast
 from typing import TYPE_CHECKING
 from urllib.parse import urlparse
 
-from anycorn.typing import ASGIReceiveCallable
-from anycorn.typing import ASGISendCallable
-from anycorn.typing import HTTPResponseBodyEvent
-from anycorn.typing import HTTPResponseStartEvent
-from anycorn.typing import HTTPScope
-from anycorn.typing import LifespanScope
-from anycorn.typing import LifespanShutdownCompleteEvent
-from anycorn.typing import LifespanShutdownFailedEvent
-from anycorn.typing import LifespanStartupCompleteEvent
-from anycorn.typing import LifespanStartupFailedEvent
-from anycorn.typing import WebsocketAcceptEvent
-from anycorn.typing import WebsocketCloseEvent
-from anycorn.typing import WebsocketResponseBodyEvent
-from anycorn.typing import WebsocketResponseStartEvent
-from anycorn.typing import WebsocketScope
 from anyio import create_memory_object_stream
 from anyio import create_task_group
 from anyio import fail_after
@@ -31,14 +16,30 @@ from anyio.abc import TaskGroup
 from werkzeug.datastructures import Headers
 from werkzeug.wrappers import Response as WerkzeugResponse
 
+from anyquart.typing import ASGIReceiveCallable
+from anyquart.typing import ASGISendCallable
+from anyquart.typing import HTTPResponseBodyEvent
+from anyquart.typing import HTTPResponseStartEvent
+from anyquart.typing import HTTPScope
+from anyquart.typing import LifespanScope
+from anyquart.typing import LifespanShutdownCompleteEvent
+from anyquart.typing import LifespanShutdownFailedEvent
+from anyquart.typing import LifespanStartupCompleteEvent
+from anyquart.typing import LifespanStartupFailedEvent
+from anyquart.typing import WebSocketAcceptEvent
+from anyquart.typing import WebSocketCloseEvent
+from anyquart.typing import WebSocketResponseBodyEvent
+from anyquart.typing import WebSocketResponseStartEvent
+from anyquart.typing import WebSocketScope
+
 from .debug import traceback_response
 from .signals import websocket_received
 from .signals import websocket_sent
 from .typing import ResponseTypes
 from .utils import encode_headers
-from .wrappers import Request  # noqa: F401
-from .wrappers import Response  # noqa: F401
-from .wrappers import Websocket  # noqa: F401
+from .wrappers import Request
+from .wrappers import Response
+from .wrappers import Websocket
 
 if TYPE_CHECKING:
     from .app import AnyQuart  # noqa: F401
@@ -180,7 +181,7 @@ class ASGIHTTPConnection:
 
 
 class ASGIWebsocketConnection:
-    def __init__(self, app: AnyQuart, scope: WebsocketScope) -> None:
+    def __init__(self, app: AnyQuart, scope: WebSocketScope) -> None:
         self.app = app
         self.scope = scope
         self._accepted = False
@@ -270,7 +271,7 @@ class ASGIWebsocketConnection:
                 ]
                 await send(
                     cast(
-                        WebsocketResponseStartEvent,
+                        WebSocketResponseStartEvent,
                         {
                             "type": "websocket.http.response.start",
                             "status": response.status_code,
@@ -282,7 +283,7 @@ class ASGIWebsocketConnection:
                     for data in response.response:
                         await send(
                             cast(
-                                WebsocketResponseBodyEvent,
+                                WebSocketResponseBodyEvent,
                                 {
                                     "type": "websocket.http.response.body",
                                     "body": data,
@@ -295,7 +296,7 @@ class ASGIWebsocketConnection:
                         async for data in body:
                             await send(
                                 cast(
-                                    WebsocketResponseBodyEvent,
+                                    WebSocketResponseBodyEvent,
                                     {
                                         "type": "websocket.http.response.body",
                                         "body": data,
@@ -305,7 +306,7 @@ class ASGIWebsocketConnection:
                             )
                 await send(
                     cast(
-                        WebsocketResponseBodyEvent,
+                        WebSocketResponseBodyEvent,
                         {
                             "type": "websocket.http.response.body",
                             "body": b"",
@@ -315,11 +316,11 @@ class ASGIWebsocketConnection:
                 )
             elif not self._closed:
                 await send(
-                    cast(WebsocketCloseEvent, {"type": "websocket.close", "code": 1000})
+                    cast(WebSocketCloseEvent, {"type": "websocket.close", "code": 1000})
                 )
         elif self._accepted and not self._closed:
             await send(
-                cast(WebsocketCloseEvent, {"type": "websocket.close", "code": 1000})
+                cast(WebSocketCloseEvent, {"type": "websocket.close", "code": 1000})
             )
 
         tg.cancel_scope.cancel()
@@ -335,7 +336,7 @@ class ASGIWebsocketConnection:
         self, send: ASGISendCallable, headers: Headers, subprotocol: str | None
     ) -> None:
         if not self._accepted:
-            message: WebsocketAcceptEvent = {
+            message: WebSocketAcceptEvent = {
                 "headers": [],
                 "subprotocol": subprotocol,
                 "type": "websocket.accept",