appfx-di 0.1.0

Dependency-free dependency injection container for appfx packages.

appfx-di

appfx-di provides a small, dependency-free dependency injection container for Python applications and reusable appfx components.

Package identity

Purpose	Name
Distribution	appfx-di
Import namespace	appfx.di
Repository	https://github.com/Dongbumlee/appfx-di
Supported Python	3.12, 3.13

Installation

python -m pip install appfx-di

For local development:

python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Quickstart

from appfx.di import Container, Lifetime


class Greeter:
    def greet(self) -> str:
        return "hello"


class LoudGreeter(Greeter):
    def greet(self) -> str:
        return "HELLO"


container = Container()
container.add_type(Greeter, lifetime=Lifetime.SINGLETON)
container.add_type(Greeter, LoudGreeter, name="loud")

default_greeter = container.get_service(Greeter)
loud_greeter = container.get_service(Greeter, name="loud")

assert default_greeter.greet() == "hello"
assert loud_greeter.greet() == "HELLO"

Scoped services

from appfx.di import Container, Lifetime

container = Container()
container.add_type(RequestState, lifetime=Lifetime.SCOPED)

async with container.create_scope() as scope:
    first = scope.get_service(RequestState)
    second = scope.get_service(RequestState)
    assert first is second

Scoped services must be resolved within an active scope. Scope disposal cleans up created scoped services in reverse creation order. shutdown_async() cleans up created singleton instances and clears singleton caches.

Validation

python -m ruff check .
python -m ruff format --check .
python -m pytest --cov
python -m mypy
python -m build
python -m twine check dist\*