dijay 0.3.22

The 'remix' your architecture needs: NestJS-style modularity, native async performance, and rigorous typing for Python 3.14+. Less boilerplate, more harmony.

🎧 dijay

Drop the beat on your dependencies.

dijay is the "remix" your architecture needs: NestJS-style modularity, native async performance, and rigorous typing for Python 3.14+. Less boilerplate, more harmony.

🚀 Features

• Modular Architecture: Organize code into @modules with imports, providers, and exports.
• Constructor Injection: Clean, testable injection via __init__ and Annotated.
• Flexible Scopes: SINGLETON, TRANSIENT, and REQUEST.
• Async Native: First-class support for asynchronous factories and lifecycle hooks.
• Custom Providers: Provide dataclass for value, class and factory bindings.
• Lifecycle Hooks: @on_bootstrap and @on_shutdown decorators.
• Circular Dependency Detection: Immediate RuntimeError on cycles.

📦 Installation

uv add dijay

⚡ Quick Start

import asyncio
from dijay import Container, injectable, module

@injectable()
class CatsService:
    def get_all(self):
        return ["Meow", "Purr"]

@module(providers=[CatsService], exports=[CatsService])
class CatsModule: ...

@module(imports=[CatsModule])
class AppModule: ...

async def main():
    async with Container.from_module(AppModule) as container:
        service = await container.resolve(CatsService)
        print(service.get_all())

if __name__ == "__main__":
    asyncio.run(main())

📖 Documentation

For the full documentation — including guides on modules, providers, injection, lifecycle hooks, FastAPI integration, and the complete API reference — visit:

🔗 leandroluk.github.io/python-dijay

🛠️ Development

uv sync
uv run pytest
uv build

📄 License

MIT