modern-di 0.2.0__tar.gz → 0.3.0__tar.gz

modern_di-0.2.0/.github/workflows/ci.yml → modern_di-0.3.0/.github/workflows/core-ci.yml

@@ -1,13 +1,21 @@
-name: main
+name: core ci
 
 on:
   push:
     branches:
       - main
-  pull_request: {}
+    paths:
+      - 'modern_di/**'
+      - 'tests/**'
+      - '.github/workflows/core-ci.yml'
+  pull_request:
+    paths:
+      - 'modern_di/**'
+      - 'tests/**'
+      - '.github/workflows/core-ci.yml'
 
 concurrency:
-  group: ${{ github.head_ref || github.run_id }}
+  group: ${{ github.head_ref || github.run_id }} core
   cancel-in-progress: true
 
 jobs:
@@ -19,7 +27,7 @@ jobs:
       - uses: astral-sh/setup-uv@v3
         with:
           enable-cache: true
-          cache-dependency-glob: "**/pyproject.toml"
+          cache-dependency-glob: "pyproject.toml"
       - run: uv python install 3.10
       - run: just install lint-ci
 
@@ -39,13 +47,6 @@ jobs:
       - uses: astral-sh/setup-uv@v3
         with:
           enable-cache: true
-          cache-dependency-glob: "**/pyproject.toml"
+          cache-dependency-glob: "pyproject.toml"
       - run: uv python install ${{ matrix.python-version }}
       - run: just install test . --cov=. --cov-report xml
-      - uses: codecov/codecov-action@v4.0.1
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
-        with:
-          files: ./coverage.xml
-          flags: unittests
-          name: codecov-${{ matrix.python-version }}

modern_di-0.3.0/.github/workflows/fastapi-ci.yml

@@ -0,0 +1,54 @@
+name: fastapi ci
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'integrations/fastapi/**'
+      - '.github/workflows/fastapi-ci.yml'
+  pull_request:
+    paths:
+      - 'integrations/fastapi/**'
+      - '.github/workflows/fastapi-ci.yml'
+
+defaults:
+  run:
+    working-directory: integrations/fastapi
+
+concurrency:
+  group: ${{ github.head_ref || github.run_id }} fastapi
+  cancel-in-progress: false
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: extractions/setup-just@v2
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - run: uv python install 3.10
+      - run: just install lint-ci
+
+  pytest:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: extractions/setup-just@v2
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - run: uv python install ${{ matrix.python-version }}
+      - run: just install test . --cov=. --cov-report xml

modern_di-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish Package
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  publish-core:
+    if: startsWith(github.ref_name, 'core')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: extractions/setup-just@v2
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - run: just publish
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+
+  publish-fastapi:
+    if: startsWith(github.ref_name, 'fastapi')
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: integrations/fastapi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: extractions/setup-just@v2
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+      - run: |
+          export SETUPTOOLS_SCM_PRETEND_VERSION=$(echo "${{ github.ref_name }}" | sed 's/^fastapi-//; s/-.*$//')
+          echo "SETUPTOOLS_SCM_PRETEND_VERSION=$SETUPTOOLS_SCM_PRETEND_VERSION"
+          just publish
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}

modern_di-0.3.0/Justfile

@@ -0,0 +1,23 @@
+default: install lint test
+
+install:
+    uv lock --upgrade
+    uv sync --all-extras --frozen
+
+lint:
+    uv run ruff format .
+    uv run ruff check . --fix
+    uv run mypy .
+
+lint-ci:
+    uv run ruff format . --check
+    uv run ruff check . --no-fix
+    uv run mypy .
+
+test *args:
+    uv run pytest tests {{ args }}
+
+publish:
+    rm -rf dist
+    uv build
+    uv publish --token $PYPI_TOKEN

{modern_di-0.2.0 → modern_di-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: modern-di
-Version: 0.2.0
+Version: 0.3.0
 Summary: Dependency Injection framework with IOC-container and scopes
 Project-URL: repository, https://github.com/modern-python/modern-di
 Project-URL: docs, https://modern-di.readthedocs.io
@@ -19,7 +19,6 @@ Description-Content-Type: text/markdown
 
 "Modern-DI"
 ==
-[![Test Coverage](https://codecov.io/gh/modern-python/modern-di/branch/main/graph/badge.svg)](https://codecov.io/gh/modern-python/modern-di)
 [![MyPy Strict](https://img.shields.io/badge/mypy-strict-blue)](https://mypy.readthedocs.io/en/stable/getting_started.html#strict-mode-and-configuration)
 [![Supported versions](https://img.shields.io/pypi/pyversions/modern-di.svg)](https://pypi.python.org/pypi/modern-di)
 [![downloads](https://img.shields.io/pypi/dm/modern-di.svg)](https://pypistats.org/packages/modern-di)
@@ -27,7 +26,7 @@ Description-Content-Type: text/markdown
 
 Dependency injection framework for Python inspired by `dependency-injector` and `dishka`.
 
-It is production-ready and gives you the following:
+It is in early development state and gives you the following:
 - DI framework with IOC-container and scopes.
 - Async and sync resolving.
 - Python 3.10-3.13 support.

{modern_di-0.2.0 → modern_di-0.3.0}/README.md

@@ -1,6 +1,5 @@
 "Modern-DI"
 ==
-[![Test Coverage](https://codecov.io/gh/modern-python/modern-di/branch/main/graph/badge.svg)](https://codecov.io/gh/modern-python/modern-di)
 [![MyPy Strict](https://img.shields.io/badge/mypy-strict-blue)](https://mypy.readthedocs.io/en/stable/getting_started.html#strict-mode-and-configuration)
 [![Supported versions](https://img.shields.io/pypi/pyversions/modern-di.svg)](https://pypi.python.org/pypi/modern-di)
 [![downloads](https://img.shields.io/pypi/dm/modern-di.svg)](https://pypistats.org/packages/modern-di)
@@ -8,7 +7,7 @@
 
 Dependency injection framework for Python inspired by `dependency-injector` and `dishka`.
 
-It is production-ready and gives you the following:
+It is in early development state and gives you the following:
 - DI framework with IOC-container and scopes.
 - Async and sync resolving.
 - Python 3.10-3.13 support.

{modern_di-0.2.0 → modern_di-0.3.0}/docs/dev/development-notes.md

@@ -9,7 +9,7 @@
   - context stacks for resources
   - overrides
 
-### Resolvers
+### Providers
 - completely stateless
 - if dependency is already saved or overridden in `Container`, returns it
 - otherwise build dependency and save it to `Container`
@@ -17,7 +17,7 @@
 
 ### Graph
 - Cannot be instantiated
-- Contains graph of `Resolvers`
+- Contains graph of `Providers`
 - Can initialize its resources and factories to container
 
 ### Questions

modern_di-0.3.0/integrations/fastapi/README.md

@@ -0,0 +1,6 @@
+"Modern-DI-FastAPI"
+==
+
+Integration of [Modern-DI](https://github.com/modern-python/modern-di) to FastAPI
+
+📚 [Documentation](https://modern-di.readthedocs.io)

modern_di-0.3.0/integrations/fastapi/modern_di_fastapi/__init__.py

@@ -0,0 +1,9 @@
+from modern_di_fastapi.depends import FromDI, setup_modern_di
+from modern_di_fastapi.middleware import ContainerMiddleware
+
+
+__all__ = [
+    "ContainerMiddleware",
+    "FromDI",
+    "setup_modern_di",
+]

modern_di-0.3.0/integrations/fastapi/modern_di_fastapi/depends.py

@@ -0,0 +1,24 @@
+import dataclasses
+import typing
+
+import fastapi
+from modern_di import Container, providers
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+
+
+@dataclasses.dataclass(slots=True, frozen=True)
+class Dependency(typing.Generic[T_co]):
+    dependency: providers.AbstractProvider[T_co]
+
+    async def __call__(self, request: fastapi.Request) -> T_co:
+        return await self.dependency.async_resolve(request.state.modern_di_container)
+
+
+def FromDI(dependency: providers.AbstractProvider[T_co], *, use_cache: bool = True) -> T_co:  # noqa: N802
+    return typing.cast(T_co, fastapi.Depends(dependency=Dependency(dependency), use_cache=use_cache))
+
+
+def setup_modern_di(container: Container, app: fastapi.FastAPI) -> None:
+    app.state.modern_di_container = container

modern_di-0.3.0/integrations/fastapi/modern_di_fastapi/middleware.py

@@ -0,0 +1,27 @@
+import typing
+
+import modern_di
+from starlette.requests import Request
+from starlette.types import ASGIApp, Receive, Scope, Send
+
+
+class ContainerMiddleware:
+    def __init__(self, app: ASGIApp) -> None:
+        self.app = app
+
+    async def __call__(
+        self,
+        scope: Scope,
+        receive: Receive,
+        send: Send,
+    ) -> None:
+        if scope["type"] != "http":
+            return await self.app(scope, receive, send)
+
+        request = Request(scope, receive=receive, send=send)
+        context: dict[str, typing.Any] = {"request": request}
+
+        container: modern_di.Container = request.app.state.modern_di_container
+        async with container.build_child_container(context=context) as request_container:
+            request.state.modern_di_container = request_container
+            return await self.app(scope, receive, send)

modern_di-0.3.0/integrations/fastapi/pyproject.toml

@@ -0,0 +1,90 @@
+[project]
+name = "modern-di-fastapi"
+description = "Modern-DI integration for FastAPI"
+authors = [
+    { name = "Artur Shiriev", email = "me@shiriev.ru" },
+]
+readme = "README.md"
+requires-python = ">=3.10,<4"
+license = "MIT"
+keywords = ["DI", "dependency injector", "ioc-container", "FastAPI", "python"]
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries",
+]
+packages = [
+    { include = "modern_di_fastapi" },
+]
+dynamic = ["version"]
+dependencies = [
+    "fastapi>=0.100",
+    "modern-di",
+]
+
+[project.urls]
+repository = "https://github.com/modern-python/modern-di"
+docs = "https://modern-di.readthedocs.io"
+
+[dependency-groups]
+dev = [
+    "httpx",
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+    "ruff",
+    "mypy",
+    "typing-extensions",
+    "asgi-lifespan",
+]
+
+[tool.uv.sources]
+modern-di = { path = "../../" }
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0"
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[tool.ruff]
+fix = true
+unsafe-fixes = true
+line-length = 120
+target-version = "py310"
+extend-exclude = [
+    "docs",
+]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D1", # allow missing docstrings
+    "S101", # allow asserts
+    "TCH", # ignore flake8-type-checking
+    "FBT", # allow boolean args
+    "ANN101", # missing-type-self
+    "ANN102", # missing-type-cls
+    "D203", # "one-blank-line-before-class" conflicting with D211
+    "D213", # "multi-line-summary-second-line" conflicting with D212
+    "COM812", # flake8-commas "Trailing comma missing"
+    "ISC001", # flake8-implicit-str-concat
+]
+isort.lines-after-imports = 2
+isort.no-lines-before = ["standard-library", "local-folder"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=. --cov-report term-missing"
+asyncio_mode = "auto"
+
+[tool.coverage.report]
+exclude_also = ["if typing.TYPE_CHECKING:"]

modern_di-0.3.0/integrations/fastapi/tests/test_fastapi_di.py

@@ -0,0 +1,69 @@
+import contextlib
+import dataclasses
+import typing
+
+import fastapi
+import httpx
+import modern_di
+import pytest
+from asgi_lifespan import LifespanManager
+from modern_di import Scope, providers
+from starlette import status
+from starlette.requests import Request
+
+import modern_di_fastapi
+from modern_di_fastapi import ContainerMiddleware, FromDI
+
+
+@contextlib.asynccontextmanager
+async def lifespan(app_: fastapi.FastAPI) -> typing.AsyncIterator[None]:
+    di_container = modern_di.Container(scope=modern_di.Scope.APP)
+    modern_di_fastapi.setup_modern_di(container=di_container, app=app_)
+    async with di_container:
+        yield
+
+
+app = fastapi.FastAPI(lifespan=lifespan)
+app.add_middleware(ContainerMiddleware)
+
+
+@dataclasses.dataclass(kw_only=True, slots=True)
+class SimpleCreator:
+    dep1: str
+
+
+@dataclasses.dataclass(kw_only=True, slots=True)
+class DependentCreator:
+    dep1: SimpleCreator
+
+
+def context_adapter_function(*, request: Request, **_: object) -> str:
+    return request.method
+
+
+app_factory = providers.Factory(Scope.APP, SimpleCreator, dep1="original")
+request_factory = providers.Factory(Scope.REQUEST, DependentCreator, dep1=app_factory.cast)
+context_adapter = providers.ContextAdapter(Scope.REQUEST, context_adapter_function)
+
+
+@app.get("/")
+async def read_root(
+    app_factory_instance: typing.Annotated[SimpleCreator, FromDI(app_factory)],
+    request_factory_instance: typing.Annotated[DependentCreator, FromDI(request_factory)],
+    method: typing.Annotated[str, FromDI(context_adapter)],
+) -> str:
+    assert isinstance(app_factory_instance, SimpleCreator)
+    assert isinstance(request_factory_instance, DependentCreator)
+    return method
+
+
+@pytest.fixture(scope="session")
+async def client() -> typing.AsyncIterator[httpx.AsyncClient]:
+    async with LifespanManager(app):
+        yield httpx.AsyncClient(app=app, base_url="http://test")
+
+
+async def test_read_main(client: httpx.AsyncClient) -> None:
+    response = await client.get("/")
+    assert response.status_code == status.HTTP_200_OK
+    assert response.json() == "GET"

{modern_di-0.2.0 → modern_di-0.3.0}/modern_di/__init__.py

@@ -7,5 +7,5 @@ __all__ = [
     "BaseGraph",
     "Container",
     "Scope",
-    "resolvers",
+    "providers",
 ]

{modern_di-0.2.0 → modern_di-0.3.0}/modern_di/container.py

@@ -3,7 +3,7 @@ import enum
 import types
 import typing
 
-from modern_di.resolver_state import ResolverState
+from modern_di.provider_state import ProviderState
 
 
 if typing.TYPE_CHECKING:
@@ -14,29 +14,37 @@ T_co = typing.TypeVar("T_co", covariant=True)
 
 
 class Container(contextlib.AbstractAsyncContextManager["Container"]):
-    __slots__ = "scope", "parent_container", "_is_async", "_resolver_states", "_overrides"
+    __slots__ = "scope", "parent_container", "context", "_is_async", "_provider_states", "_overrides"
 
-    def __init__(self, *, scope: enum.IntEnum, parent_container: typing.Optional["Container"] = None) -> None:
+    def __init__(
+        self,
+        *,
+        scope: enum.IntEnum,
+        parent_container: typing.Optional["Container"] = None,
+        context: dict[str, typing.Any] | None = None,
+    ) -> None:
         if scope.value != 1 and parent_container is None:
             msg = "Only first scope can be used without parent_container"
             raise RuntimeError(msg)
 
         self.scope = scope
         self.parent_container = parent_container
+        self.context: dict[str, typing.Any] = context or {}
         self._is_async: bool | None = None
-        self._resolver_states: dict[str, ResolverState[typing.Any]] = {}
+        self._provider_states: dict[str, ProviderState[typing.Any]] = {}
         self._overrides: dict[str, typing.Any] = {}
 
     def _exit(self) -> None:
         self._is_async = None
-        self._resolver_states = {}
+        self._provider_states = {}
+        self._overrides = {}
 
     def _check_entered(self) -> None:
         if self._is_async is None:
             msg = "Enter the context first"
             raise RuntimeError(msg)
 
-    def build_child_container(self) -> "typing_extensions.Self":
+    def build_child_container(self, context: dict[str, typing.Any] | None = None) -> "typing_extensions.Self":
         self._check_entered()
 
         try:
@@ -45,7 +53,7 @@ class Container(contextlib.AbstractAsyncContextManager["Container"]):
             msg = f"Max scope is reached, {self.scope.name}"
             raise RuntimeError(msg) from exc
 
-        return self.__class__(scope=new_scope, parent_container=self)
+        return self.__class__(scope=new_scope, parent_container=self, context=context)
 
     def find_container(self, scope: enum.IntEnum) -> "typing_extensions.Self":
         container = self
@@ -53,30 +61,30 @@ class Container(contextlib.AbstractAsyncContextManager["Container"]):
             container = typing.cast("typing_extensions.Self", container.parent_container)
         return container
 
-    def fetch_resolver_state(
-        self, resolver_id: str, is_async_resource: bool = False, is_lock_required: bool = False
-    ) -> ResolverState[typing.Any]:
+    def fetch_provider_state(
+        self, provider_id: str, is_async_resource: bool = False, is_lock_required: bool = False
+    ) -> ProviderState[typing.Any]:
         self._check_entered()
         if is_async_resource and self._is_async is False:
             msg = "Resolving async resource in sync container is not allowed"
             raise RuntimeError(msg)
 
-        if resolver_id not in self._resolver_states:
-            self._resolver_states[resolver_id] = ResolverState(is_lock_required=is_lock_required)
+        if provider_id not in self._provider_states:
+            self._provider_states[provider_id] = ProviderState(is_lock_required=is_lock_required)
 
-        return self._resolver_states[resolver_id]
+        return self._provider_states[provider_id]
 
-    def override(self, resolver_id: str, override_object: object) -> None:
-        self._overrides[resolver_id] = override_object
+    def override(self, provider_id: str, override_object: object) -> None:
+        self._overrides[provider_id] = override_object
 
-    def fetch_override(self, resolver_id: str) -> object | None:
-        return self._overrides.get(resolver_id)
+    def fetch_override(self, provider_id: str) -> object | None:
+        return self._overrides.get(provider_id)
 
-    def reset_override(self, resolver_id: str | None = None) -> None:
-        if resolver_id is None:
+    def reset_override(self, provider_id: str | None = None) -> None:
+        if provider_id is None:
             self._overrides = {}
         else:
-            self._overrides.pop(resolver_id, None)
+            self._overrides.pop(provider_id, None)
 
     async def __aenter__(self) -> "Container":
         self._is_async = True
@@ -89,8 +97,8 @@ class Container(contextlib.AbstractAsyncContextManager["Container"]):
         traceback: types.TracebackType | None,
     ) -> None:
         self._check_entered()
-        for resolver_state in reversed(self._resolver_states.values()):
-            await resolver_state.async_tear_down()
+        for provider_state in reversed(self._provider_states.values()):
+            await provider_state.async_tear_down()
         self._exit()
 
     def __enter__(self) -> "Container":
@@ -104,6 +112,6 @@ class Container(contextlib.AbstractAsyncContextManager["Container"]):
         traceback: types.TracebackType | None,
     ) -> None:
         self._check_entered()
-        for resolver_state in reversed(self._resolver_states.values()):
-            resolver_state.sync_tear_down()
+        for provider_state in reversed(self._provider_states.values()):
+            provider_state.sync_tear_down()
         self._exit()

modern_di-0.3.0/modern_di/graph.py

@@ -0,0 +1,39 @@
+import typing
+
+from modern_di import Container
+from modern_di.providers import AbstractProvider, BaseCreatorProvider
+
+
+if typing.TYPE_CHECKING:
+    import typing_extensions
+
+
+T = typing.TypeVar("T")
+P = typing.ParamSpec("P")
+
+
+class BaseGraph:
+    providers: dict[str, AbstractProvider[typing.Any]]
+
+    def __new__(cls, *_: typing.Any, **__: typing.Any) -> "typing_extensions.Self":  # noqa: ANN401
+        msg = f"{cls.__name__} cannot not be instantiated"
+        raise RuntimeError(msg)
+
+    @classmethod
+    def get_providers(cls) -> dict[str, AbstractProvider[typing.Any]]:
+        if not hasattr(cls, "providers"):
+            cls.providers = {k: v for k, v in cls.__dict__.items() if isinstance(v, AbstractProvider)}
+
+        return cls.providers
+
+    @classmethod
+    async def async_resolve_creators(cls, container: Container) -> None:
+        for provider in cls.get_providers().values():
+            if isinstance(provider, BaseCreatorProvider) and provider.scope == container.scope:
+                await provider.async_resolve(container)
+
+    @classmethod
+    def sync_resolve_creators(cls, container: Container) -> None:
+        for provider in cls.get_providers().values():
+            if isinstance(provider, BaseCreatorProvider) and provider.scope == container.scope:
+                provider.sync_resolve(container)

modern_di-0.2.0/modern_di/resolver_state.py → modern_di-0.3.0/modern_di/provider_state.py

@@ -6,13 +6,13 @@ import typing
 T_co = typing.TypeVar("T_co", covariant=True)
 
 
-class ResolverState(typing.Generic[T_co]):
-    __slots__ = "context_stack", "instance", "resolver_lock"
+class ProviderState(typing.Generic[T_co]):
+    __slots__ = "context_stack", "instance", "provider_lock"
 
     def __init__(self, is_lock_required: bool) -> None:
         self.context_stack: contextlib.AsyncExitStack | contextlib.ExitStack | None = None
         self.instance: T_co | None = None
-        self.resolver_lock: typing.Final = asyncio.Lock() if is_lock_required else None
+        self.provider_lock: typing.Final = asyncio.Lock() if is_lock_required else None
 
     async def async_tear_down(self) -> None:
         if self.context_stack is None:

modern_di-0.3.0/modern_di/providers/__init__.py

@@ -0,0 +1,15 @@
+from modern_di.providers.base import AbstractProvider, BaseCreatorProvider
+from modern_di.providers.context_adapter import ContextAdapter
+from modern_di.providers.factory import Factory
+from modern_di.providers.resource import Resource
+from modern_di.providers.singleton import Singleton
+
+
+__all__ = [
+    "AbstractProvider",
+    "BaseCreatorProvider",
+    "ContextAdapter",
+    "Factory",
+    "Singleton",
+    "Resource",
+]