| Project | Badges |
|---|---|
| modern-di |   |
| modern-di-aiohttp |   |
| modern-di-fastapi |   |
| modern-di-faststream |   |
| modern-di-litestar |   |
| modern-di-pytest |   |
| modern-di-starlette |   |
| modern-di-typer |   |
modern-di is a python dependency injection framework which supports the following:
- Automatic dependency graph based on type annotations
- Also, explicit dependencies are allowed where needed
- Scopes and context management
- Python 3.10+ support
- Fully typed and tested
- Integrations with
aiohttp,FastAPI,FastStream,Litestar,StarletteandTyper - Pytest integration (
modern-di-pytest) — turns any DI dependency into a pytest fixture
Install
uv add modern-di # or: pip install modern-di
Quick Start
import dataclasses
from modern_di import Container, Group, Scope, providers
@dataclasses.dataclass(kw_only=True, slots=True, frozen=True)
class Settings:
database_url: str = "postgresql+asyncpg://localhost/app"
@dataclasses.dataclass(kw_only=True, slots=True)
class UserRepository:
settings: Settings # auto-injected by type
class Dependencies(Group):
settings = providers.Factory(scope=Scope.APP, creator=Settings)
user_repository = providers.Factory(scope=Scope.REQUEST, creator=UserRepository)
with Container(groups=[Dependencies], validate=True) as container:
with container.build_child_container(scope=Scope.REQUEST) as request:
repo = request.resolve(UserRepository)
print(repo.settings.database_url)
See the documentation for scopes, lifecycles, finalizers, and framework integrations.
Usage examples:
- with Litestar - litestar-sqlalchemy-template
- with FastAPI - fastapi-sqlalchemy-template
📚 Documentation
📦 PyPI
📝 License
Part of modern-python
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
modern_di-2.22.0.tar.gz
(20.2 kB
view details)
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-2.22.0.tar.gz.
File metadata
- Download URL: modern_di-2.22.0.tar.gz
- Upload date:
- Size: 20.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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 |
f1cfa87a3c5225ef63db4c9e4c103ed2c526e1e59bf7d41a68b7eef0ceaf700a
|
|
| MD5 |
051c35889a1090b5539feb2348bd0e48
|
|
| BLAKE2b-256 |
5e194248d91ce0eef80b51ebb0615d96dc98deed6d77a3ebd3d29614d21df9db
|
File details
Details for the file modern_di-2.22.0-py3-none-any.whl.
File metadata
- Download URL: modern_di-2.22.0-py3-none-any.whl
- Upload date:
- Size: 28.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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 |
cdc864822782b8bbf6dba06603cd9fcb6160af52df583453dfc8776e2e8318e8
|
|
| MD5 |
6d80c9fc9e254b55dab02e5f784a5e8b
|
|
| BLAKE2b-256 |
1af556aa48d3643d7a46d57540641dafd0fc01386560c27d49d35ee6d868fe76
|
