modern-di-typer 2.0.0

Modern-DI integration for Typer

"Modern-DI-Typer"

Integration of Modern-DI to Typer

📚 Documentation

Installation

pip install modern-di-typer

Usage

import typing
import typer
import modern_di
from modern_di import Scope, providers, Group
from modern_di_typer import FromDI, inject, setup_di


class Dependencies(Group):
    settings = providers.Factory(creator=lambda: {"debug": True})
    service = providers.Factory(scope=Scope.REQUEST, creator=MyService, bound_type=None)


app = typer.Typer()
container = modern_di.Container(groups=[Dependencies])
setup_di(app, container)


@app.command()
@inject
def my_command(
    name: typing.Annotated[str, typer.Argument()],
    service: typing.Annotated[MyService, FromDI(Dependencies.service)],
) -> None:
    service.run(name)


if __name__ == "__main__":
    app()
    container.close_sync()

API

• setup_di(app, container) — register the container with a Typer app
• inject — decorator that resolves FromDI-annotated parameters before the command runs; also exposes typer.Context with ctx.obj["di_container"] for manual use
• FromDI(provider) — marker used in Annotated[T, FromDI(...)]; accepts a provider instance or a type
• build_command_container(ctx) — context manager yielding a Scope.REQUEST child container; use inside @inject commands for Scope.ACTION work
• fetch_di_container(ctx) — returns the app-scoped container from ctx.obj