spritze 0.1.0

A Dependency Injection framework for Python.

spritze

A Dependency Injection framework for Python.

License

Apache 2.0 — see LICENSE

Features

• Modern, type-safe dependency injection for Python 3.11+
• Scopes: APP (singleton), REQUEST (per-request)
• Sync & async support, context managers
• No global state, explicit containers
• Decorator-based provider registration
• Easy integration with FastAPI, Flask, Litestar, etc.

Installation

uv add spritze
# or
pip install spritze

Usage

Here's a quick example of how to use Spritze:

from spritze.core.container import Container
from spritze.core.entities import Depends, Scope
from spritze.decorators import provide


class MyService:
    def __init__(self, value: int):
        self.value = value


class AppContainer(Container):
    @provide(scope=Scope.APP)
    def provide_config_value(self) -> int:
        return 123

    @provide(scope=Scope.REQUEST)
    def provide_my_service(self, config_value: int) -> MyService:
        return MyService(value=config_value)


app_container = AppContainer()


@app_container.injector()
def my_function(service: Depends[MyService]):
    return f"Service value: {service.value}"


if __name__ == "__main__":
    result = my_function()
    print(result)  # Output: Service value: 123

Examples

See the examples/ directory for real-world usage with Flask, Litestar, etc.