Modern-DI integration for FastAPI.
Full guide: FastAPI integration docs
Usage example: fastapi-sqlalchemy-template
Installation
uv add modern-di-fastapi # or: pip install modern-di-fastapi
Usage
setup_di registers the container and builds a per-request child container automatically; FromDI resolves a provider (or type) into a route parameter.
import dataclasses
import fastapi
from modern_di import Container, Group, Scope, providers
from modern_di_fastapi import FromDI, setup_di
@dataclasses.dataclass(kw_only=True)
class Settings:
debug: bool = True
@dataclasses.dataclass(kw_only=True)
class UserService:
settings: Settings # auto-injected by type
class Dependencies(Group):
settings = providers.Factory(scope=Scope.APP, creator=Settings)
user_service = providers.Factory(scope=Scope.REQUEST, creator=UserService)
app = fastapi.FastAPI()
container = Container(groups=[Dependencies])
setup_di(app, container)
container.validate() # optional fail-fast; must come after setup_di registers its providers
@app.get("/")
async def index(user_service: UserService = FromDI(Dependencies.user_service)) -> dict[str, bool]:
return {"debug": user_service.settings.debug}
The framework Request / WebSocket are resolvable within DI via the pre-built fastapi_request_provider / fastapi_websocket_provider context providers.
API
| Symbol | Description |
|---|---|
setup_di(app, container) |
Stores the container on app.state and appends a lifespan that closes it on shutdown (merges with any existing lifespan=) |
FromDI(provider, *, use_cache=True) |
FastAPI Depends that resolves a provider (or type) from the per-request child container |
fetch_di_container(app) |
Returns the app-scoped container from app.state |
build_di_container(connection) |
FastAPI Depends callable that yields the per-request child container — REQUEST scope for an HTTP request, SESSION scope for a WebSocket |
fastapi_request_provider |
ContextProvider for the current fastapi.Request |
fastapi_websocket_provider |
ContextProvider for the current fastapi.WebSocket |
📦 PyPI
📝 License
Part of modern-python
Built on modern-di, a dependency-injection framework with IoC container and scopes.
Browse the full list of templates and libraries in
modern-python — see the org profile for the categorized index.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file modern_di_fastapi-3.0.1.tar.gz.
File metadata
- Download URL: modern_di_fastapi-3.0.1.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b19d51d81313c6d5cea8607eaf1a9fa43e75df2ab0f2d467e8178fd85021a73e
|
|
| MD5 |
6d7a004aa850ca8db343a246380839e8
|
|
| BLAKE2b-256 |
f68c178333c633ba4d580bc5a358d411de1a3da01cad61fca1528f56dbc2c3f8
|
File details
Details for the file modern_di_fastapi-3.0.1-py3-none-any.whl.
File metadata
- Download URL: modern_di_fastapi-3.0.1-py3-none-any.whl
- Upload date:
- Size: 4.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83fafb6c5cd762b14b1fcf31bf520e2df6cfc8801e5e7640a1109b555d942a46
|
|
| MD5 |
5f020139b35d7820fb2cb671f822c8f2
|
|
| BLAKE2b-256 |
0f80b1c280036ad45a9138024e00da296556e6af636dc50de4c2b835631ba41e
|
