AnyDI

Simple Dependency Injection library that uses Python type annotations.

Documentation

http://anydi.readthedocs.io/

AnyDI is a simple Dependency Injection library for Python 3.10+. It works with sync and async applications and uses type annotations (PEP 484).

Main features:

Type-safe: Uses type hints for dependency resolution.
Async support: Works with both sync and async code.
Scopes: Provides singleton, transient, and request scopes. Supports custom scope definitions.
Simple: Minimal boilerplate with straightforward API.
Fast: Low overhead dependency resolution.
Named providers: Use Annotated[...] for multiple providers per type.
Resource management: Context manager protocol support for lifecycle management.
Modular: Container and module composition for large applications.
Auto-scan: Automatic discovery of injectable callables.
Lazy references: Module-level access to dependencies without injection.
Generic support: Automatic TypeVar resolution for generic base classes.
Framework integrations: Extensions for popular frameworks.
Testing: Provider override mechanism for test isolation.

Installation

pip install anydi

Quick Example

Define a Service (`app/services.py`)

class GreetingService:
    def greet(self, name: str) -> str:
        return f"Hello, {name}!"

Create the Container and Providers (`app/container.py`)

from anydi import Container

from app.services import GreetingService


container = Container()


@container.provider(scope="singleton")
def service() -> GreetingService:
    return GreetingService()

Resolve Dependencies Directly

from app.container import container
from app.services import GreetingService


service = container.resolve(GreetingService)

if __name__ == "__main__":
    print(service.greet("World"))

Inject Into Functions (`app/main.py`)

from anydi import Provide

from app.container import container
from app.services import GreetingService


def greet(service: Provide[GreetingService]) -> str:
    return service.greet("World")


if __name__ == "__main__":
    print(container.run(greet))

Or Use a Lazy Reference (`app/main.py`)

from app.container import container
from app.services import GreetingService


service = container.ref(GreetingService)


def greet() -> str:
    return service.greet("World")


if __name__ == "__main__":
    print(greet())

The container owns the providers, scopes and lifespan either way. Injection and lazy references are two styles of reaching the same dependency.

Test with Overrides (`tests/test_app.py`)

from unittest import mock

from app.container import container
from app.services import GreetingService
from app.main import greet


def test_greet() -> None:
    service_mock = mock.Mock(spec=GreetingService)
    service_mock.greet.return_value = "Mocked"

    with container.override(GreetingService, service_mock):
        result = container.run(greet)

    assert result == "Mocked"

Integrate with FastAPI (`app/api.py`)

from typing import Annotated

import anydi.ext.fastapi
from fastapi import FastAPI

from anydi import Provide
from app.container import container
from app.services import GreetingService


app = FastAPI()


@app.get("/greeting")
async def greet(
    service: Provide[GreetingService]
) -> dict[str, str]:
    return {"greeting": service.greet("World")}


anydi.ext.fastapi.install(app, container)

Test the FastAPI Integration (`test_api.py`)

from unittest import mock

from fastapi.testclient import TestClient

from app.api import app
from app.container import container
from app.services import GreetingService


client = TestClient(app)


def test_api_greeting() -> None:
    service_mock = mock.Mock(spec=GreetingService)
    service_mock.greet.return_value = "Mocked"

    with container.override(GreetingService, service_mock):
        response = client.get("/greeting")

    assert response.json() == {"greeting": "Mocked"}

Integrate with Django Ninja

Install the Django integration extras:

pip install 'anydi-django[ninja]'

Expose the container factory (app/container.py):

from anydi import Container

from app.services import GreetingService


container = Container()


@container.provider(scope="singleton")
def service() -> GreetingService:
    return GreetingService()

Configure Django (settings.py):

INSTALLED_APPS = [
    ...,
    "anydi_django",
]

ANYDI = {
    "CONTAINER_FACTORY": "app.container.container",
    "PATCH_NINJA": True,
}

Wire Django Ninja (urls.py):

from typing import Annotated, Any

from anydi import Provide
from django.http import HttpRequest
from django.urls import path
from ninja import NinjaAPI

from app.services import GreetingService


api = NinjaAPI()


@api.get("/greeting")
def greet(request: HttpRequest, service: Provide[GreetingService]) -> Any:
    return {"greeting": service.greet("World")}


urlpatterns = [
    path("api/", api.urls),
]

Learn More

Want to know more? Here are helpful resources:

Core Documentation:

Core Concepts - Learn about containers, providers, scopes, and dependency injection
Providers - How to register providers and manage resources
Scopes - How to use built-in and custom scopes
Dependency Injection - Different ways to inject dependencies
Testing - How to test your code with provider overrides

Framework Integrations:

FastAPI - How to use with FastAPI
Django - How to use with Django and Django Ninja
FastStream - How to use with message brokers
Typer - How to use in CLI applications
Pydantic Settings - How to manage configuration

Full Documentation:

Read the Docs - All documentation with examples and guides

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anydi-0.79.1.tar.gz (40.3 kB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

anydi-0.79.1-py3-none-any.whl (49.7 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file anydi-0.79.1.tar.gz.

File metadata

Download URL: anydi-0.79.1.tar.gz
Upload date: Jul 28, 2026
Size: 40.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for anydi-0.79.1.tar.gz
Algorithm	Hash digest
SHA256	`795c366687e35262d1c925ece20a1ca9299fd8f591bfb842d0bcf4517eb989b9`
MD5	`fe0d60f1b3009665e567fb488189bde9`
BLAKE2b-256	`907f5f0e320ae711d27c19c58fcafbe011c64796f753258699929d9065d1bf30`

See more details on using hashes here.

File details

Details for the file anydi-0.79.1-py3-none-any.whl.

File metadata

Download URL: anydi-0.79.1-py3-none-any.whl
Upload date: Jul 28, 2026
Size: 49.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for anydi-0.79.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`95aaf7ef9851ef05941c02daa0346bf73cf09662bc03ffa86cbf8294038d472b`
MD5	`b69376e1d87e56a0e9962b4755646ee5`
BLAKE2b-256	`101038dc7843c90c80ebb1d3cc37de3871ac27904c3b3aa029a79d0e9eef714e`