modern-di-aiohttp 2.0.0 — first release
First release of the aiohttp integration for modern-di. It wires a
modern-di container into an aiohttp
web.Application and resolves dependencies into handlers. The version starts
at 2.0.0 to track the modern-di 2.x ecosystem alongside the other official
integrations.
aiohttp has no dependency-injection system of its own, so this integration
follows modern-di's decorator path: middleware owns the per-connection
container lifecycle, and an @inject decorator with FromDI markers resolves
dependencies.
Feature
setup_di(app, container). Stashes the root container on the app
(web.AppKey("modern_di_container", Container), read back with
fetch_di_container(app)), registers the connection providers, reopens the
container onon_startup(so repeated startup/cleanup cycles work), closes
it onon_cleanup, and installs the DI middleware. Returns the container.- Per-connection child containers. Middleware detects a WebSocket upgrade
viaweb.WebSocketResponse().can_prepare(request).okand opens a
Scope.REQUESTchild container for each HTTP request or aScope.SESSION
child for each WebSocket connection, injecting the connection as context and
closing the child when the connection ends. A handler reads its child
container withfetch_request_container(request). Per-message work inside a
WebSocket handler can open a nestedScope.REQUESTchild of the SESSION
container. FromDI+@inject. Mark a handler parameter with
Annotated[T, FromDI(provider_or_type)]and decorate the handler with
@inject; the decorator resolves each marked parameter from the
connection's child container. A clearRuntimeErroris raised if@inject
runs withoutsetup_di.aiohttp_request_provider/aiohttp_websocket_provider. Connection
providers exposing theweb.Request: the former is registered by type at
Scope.REQUESTfor HTTP handlers; the latter is reference-only
(bound_type=None) atScope.SESSIONfor WebSocket handlers, injected via
FromDI(aiohttp_websocket_provider).
Packaging
- Requires
aiohttp>=3.9,<4andmodern-di>=2.21.0,<3; Python 3.10–3.14. - Ships
py.typed; zero runtime dependencies beyond aiohttp and modern-di.
Downstream
No action needed — this is a new package.
Internals
- 100% line coverage;
ruff,ty, andeof-fixerclean across Python
3.10–3.14. - Uses the portable planning convention (
planning/) with anarchitecture/
truth home; releases are tag-driven.