spryx-di 2.0.0

Lightweight type-based dependency injection for Python modular monoliths

spryx-di

Lightweight dependency injection for Python modular monoliths.

• NestJS-inspired modules with providers, exports, and imports
• Type-based auto-wiring via __init__ type hints
• Module boundary enforcement at boot time
• Zero runtime dependencies
• Zero intrusion in domain code

Install

pip install spryx-di

Quick Example

from spryx_di import ClassProvider, Module, ApplicationContext

identity_module = Module(
    name="identity",
    providers=[
        ClassProvider(provide=UserRepository, use_class=PgUserRepository),
        ClassProvider(provide=UserReader, use_class=PgUserReader),
    ],
    exports=[UserReader],
)

orders_module = Module(
    name="orders",
    providers=[
        ClassProvider(provide=OrderRepository, use_class=PgOrderRepository),
    ],
    imports=[identity_module],
)

ctx = ApplicationContext(modules=[identity_module, orders_module])
handler = ctx.resolve(CreateOrderHandler)  # auto-wired from type hints

Handlers declare dependencies via __init__ — no decorators, no DI imports:

class CreateOrderHandler:
    def __init__(self, repo: OrderRepository, reader: UserReader) -> None:
        self._repo = repo
        self._reader = reader

Features

Feature	Description
ClassProvider, FactoryProvider, ValueProvider, ExistingProvider	Typed providers — use_class, use_factory, use_value, use_existing with Scope.SINGLETON (default) or TRANSIENT
Module	Declarative providers, exports, imports, on_destroy
ApplicationContext	Composes modules with boundary enforcement and boot-time validation
forward_ref()	Circular module dependencies without Python import errors
Lifecycle	on_destroy per module, auto-close managed instances, await ctx.shutdown()
FastAPI	Inject(), ScopedInject(), configure(), request scope middleware
Testing	override() context manager, Container with fakes

Documentation

https://spryx-ai.github.io/spryx-di

Development

make install   # deps + pre-commit hooks
make check     # lint + typecheck + tests
make docs      # serve docs locally

License

MIT