Modern, lightweight Dependency Injection library using type annotations.
Documentation
AnyDI is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.9+, based on type annotations (PEP 484).
The key features are:
- Type-safe: Resolves dependencies using type annotations.
- Async Support: Compatible with both synchronous and asynchronous providers and injections.
- Scoping: Supports singleton, transient, and request scopes.
- Easy to Use: Designed for simplicity and minimal boilerplate.
-
Named Dependencies: Supports named dependencies using
Annotatedtype. - Resource Management: Manages resources using context managers.
- Modular: Facilitates a modular design with support for multiple modules.
- Scanning: Automatically scans for injectable functions and classes.
- Integrations: Provides easy integration with popular frameworks and libraries.
- Testing: Simplifies testing by allowing provider overrides.
pip install anydiapp.py
from anydi import auto, Container
container = Container()
@container.provider(scope="singleton")
def message() -> str:
return "Hello, world!"
@container.inject
def say_hello(message: str = auto) -> None:
print(message)
if __name__ == "__main__":
say_hello()app.py
from fastapi import FastAPI
import anydi.ext.fastapi
from anydi import Container
from anydi.ext.fastapi import Inject
container = Container()
@container.provider(scope="singleton")
def message() -> str:
return "Hello, World!"
app = FastAPI()
@app.get("/hello")
def say_hello(message: str = Inject()) -> dict[str, str]:
return {"message": message}
# Install the container into the FastAPI app
anydi.ext.fastapi.install(app, container)container.py
from anydi import Container
def get_container() -> Container:
container = Container()
@container.provider(scope="singleton")
def message() -> str:
return "Hello, World!"
return containersettings.py
INSTALLED_APPS = [
...
"anydi.ext.django",
]
ANYDI = {
"CONTAINER_FACTORY": "myapp.container.get_container",
"PATCH_NINJA": True,
}urls.py
from django.http import HttpRequest
from django.urls import path
from ninja import NinjaAPI
from anydi import auto
api = NinjaAPI()
@api.get("/hello")
def say_hello(request: HttpRequest, message: str = auto) -> dict[str, str]:
return {"message": message}
urlpatterns = [
path("api/", api.urls),
]
