Dishka Dependency Injection Skill

Overview

Dishka is a Python dependency injection framework built around Providers, Scopes, and typed containers. It supports async/sync workflows and integrates with web frameworks (Litestar, FastAPI) and CLI tools (Click).

---

<workflow>

References Index

For detailed guides and configuration examples, refer to the following documents in references/:

• Providers, Scopes & Factory Functions
  • Core concepts, scope hierarchy, container creation, provider patterns, clean naming, and best practices.
• Litestar Integration
  • Setup, controller injection, router integration, and manual resolution from connection.
• FastAPI Integration
  • Setup and route-level injection with FromDishka.
• CLI Integration
  • Click with async_inject decorator for Dishka-powered CLI commands.
• Testing Patterns
  • Test containers, mock providers, and override strategies.

</workflow> <example>

Example: Provider and Container Setup

from dishka import Provider, Scope, make_async_container, provide

class AppProvider(Provider):
    scope = Scope.APP

    @provide
    async def get_db_engine(self) -> AsyncEngine:
        return create_async_engine("postgresql+asyncpg://...")

class RequestProvider(Provider):
    scope = Scope.REQUEST

    @provide
    async def get_session(self, engine: AsyncEngine) -> AsyncSession:
        return AsyncSession(engine)

container = make_async_container(AppProvider(), RequestProvider())

</example>

---

Official References

• https://dishka.readthedocs.io/en/stable/
• https://dishka.readthedocs.io/en/stable/integrations/litestar.html
• https://dishka.readthedocs.io/en/stable/integrations/fastapi.html
• https://dishka.readthedocs.io/en/stable/integrations/click.html
• https://github.com/reagento/dishka/releases
• https://pypi.org/project/dishka/

Shared Styleguide Baseline

• Use shared styleguides for generic language/framework rules to reduce duplication in this skill.
• General Principles
• Dishka
• Python
• Keep this skill focused on tool-specific workflows, edge cases, and integration details.