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

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