modern-di 0.2.1__tar.gz → 0.4.0__tar.gz

{modern_di-0.2.1 → modern_di-0.4.0}/.github/workflows/publish.yml

@@ -23,6 +23,9 @@ jobs:
   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
@@ -31,7 +34,8 @@ jobs:
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"
       - run: |
-          cd integrations/fastapi
+          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.4.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.3
+Name: modern-di
+Version: 0.4.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
+Author-email: Artur Shiriev <me@shiriev.ru>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dependency injector,di,ioc-container,mocks,python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.10
+Description-Content-Type: text/markdown
+
+"Modern-DI"
+==
+
+| Project           | Badges                                                                                                                                                                                                                                                                                          |
+|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| common            | [![MyPy Strict](https://img.shields.io/badge/mypy-strict-blue)](https://mypy.readthedocs.io/en/stable/getting_started.html#strict-mode-and-configuration) [![GitHub stars](https://img.shields.io/github/stars/modern-python/modern-di)](https://github.com/modern-python/modern-di/stargazers) |
+| modern-di         | [![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)                                                                   |
+| modern-di-fastapi | [![Supported versions](https://img.shields.io/pypi/pyversions/modern-di-fastapi.svg)](https://pypi.python.org/pypi/modern-di-fastapi) [![downloads](https://img.shields.io/pypi/dm/modern-di-fastapi.svg)](https://pypistats.org/packages/modern-di-fastapi)                                    |
+
+Dependency injection framework for Python inspired by `dependency-injector` and `dishka`.
+
+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.
+- Full coverage by types annotations (mypy in strict mode).
+- Overriding dependencies for tests.
+- Package with zero dependencies.
+
+📚 [Documentation](https://modern-di.readthedocs.io)

modern_di-0.4.0/README.md

@@ -0,0 +1,20 @@
+"Modern-DI"
+==
+
+| Project           | Badges                                                                                                                                                                                                                                                                                          |
+|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| common            | [![MyPy Strict](https://img.shields.io/badge/mypy-strict-blue)](https://mypy.readthedocs.io/en/stable/getting_started.html#strict-mode-and-configuration) [![GitHub stars](https://img.shields.io/github/stars/modern-python/modern-di)](https://github.com/modern-python/modern-di/stargazers) |
+| modern-di         | [![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)                                                                   |
+| modern-di-fastapi | [![Supported versions](https://img.shields.io/pypi/pyversions/modern-di-fastapi.svg)](https://pypi.python.org/pypi/modern-di-fastapi) [![downloads](https://img.shields.io/pypi/dm/modern-di-fastapi.svg)](https://pypistats.org/packages/modern-di-fastapi)                                    |
+
+Dependency injection framework for Python inspired by `dependency-injector` and `dishka`.
+
+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.
+- Full coverage by types annotations (mypy in strict mode).
+- Overriding dependencies for tests.
+- Package with zero dependencies.
+
+📚 [Documentation](https://modern-di.readthedocs.io)

{modern_di-0.2.1 → modern_di-0.4.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.2.1 → modern_di-0.4.0}/integrations/fastapi/modern_di_fastapi/depends.py

@@ -2,7 +2,7 @@ import dataclasses
 import typing
 
 import fastapi
-import modern_di
+from modern_di import Container, providers
 
 
 T_co = typing.TypeVar("T_co", covariant=True)
@@ -10,15 +10,15 @@ T_co = typing.TypeVar("T_co", covariant=True)
 
 @dataclasses.dataclass(slots=True, frozen=True)
 class Dependency(typing.Generic[T_co]):
-    dependency: modern_di.resolvers.AbstractResolver[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: modern_di.resolvers.AbstractResolver[T_co], *, use_cache: bool = True) -> T_co:  # noqa: N802
+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: modern_di.Container, app: fastapi.FastAPI) -> None:
+def setup_modern_di(container: Container, app: fastapi.FastAPI) -> None:
     app.state.modern_di_container = container

{modern_di-0.2.1 → modern_di-0.4.0}/integrations/fastapi/tests/test_fastapi_di.py

@@ -7,7 +7,7 @@ import httpx
 import modern_di
 import pytest
 from asgi_lifespan import LifespanManager
-from modern_di import Scope, resolvers
+from modern_di import Scope, providers
 from starlette import status
 from starlette.requests import Request
 
@@ -41,9 +41,9 @@ def context_adapter_function(*, request: Request, **_: object) -> str:
     return request.method
 
 
-app_factory = resolvers.Factory(Scope.APP, SimpleCreator, dep1="original")
-request_factory = resolvers.Factory(Scope.REQUEST, DependentCreator, dep1=app_factory.cast)
-context_adapter = resolvers.ContextAdapter(Scope.REQUEST, context_adapter_function)
+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("/")

{modern_di-0.2.1 → modern_di-0.4.0}/modern_di/__init__.py

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

{modern_di-0.2.1 → modern_di-0.4.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,7 +14,7 @@ T_co = typing.TypeVar("T_co", covariant=True)
 
 
 class Container(contextlib.AbstractAsyncContextManager["Container"]):
-    __slots__ = "scope", "parent_container", "context", "_is_async", "_resolver_states", "_overrides"
+    __slots__ = "scope", "parent_container", "context", "_is_async", "_provider_states", "_overrides"
 
     def __init__(
         self,
@@ -31,12 +31,12 @@ class Container(contextlib.AbstractAsyncContextManager["Container"]):
         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:
@@ -61,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
@@ -97,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":
@@ -112,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.4.0/modern_di/graph.py

@@ -0,0 +1,39 @@
+import typing
+
+from modern_di import Container
+from modern_di.providers.abstract import AbstractCreatorProvider, AbstractProvider
+
+
+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, AbstractCreatorProvider) 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, AbstractCreatorProvider) and provider.scope == container.scope:
+                provider.sync_resolve(container)

modern_di-0.2.1/modern_di/resolver_state.py → modern_di-0.4.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.4.0/modern_di/providers/__init__.py

@@ -0,0 +1,16 @@
+from modern_di.providers.dict import Dict
+from modern_di.providers.factory import Factory
+from modern_di.providers.list import List
+from modern_di.providers.resource import Resource
+from modern_di.providers.selector import Selector
+from modern_di.providers.singleton import Singleton
+
+
+__all__ = [
+    "Factory",
+    "Dict",
+    "List",
+    "Selector",
+    "Singleton",
+    "Resource",
+]

modern_di-0.2.1/modern_di/resolvers/base.py → modern_di-0.4.0/modern_di/providers/abstract.py

@@ -12,12 +12,12 @@ R = typing.TypeVar("R")
 P = typing.ParamSpec("P")
 
 
-class AbstractResolver(typing.Generic[T_co], abc.ABC):
-    BASE_SLOTS: typing.ClassVar = ["scope", "resolver_id"]
+class AbstractProvider(typing.Generic[T_co], abc.ABC):
+    BASE_SLOTS: typing.ClassVar = ["scope", "provider_id"]
 
     def __init__(self, scope: enum.IntEnum) -> None:
         self.scope = scope
-        self.resolver_id: typing.Final = str(uuid.uuid4())
+        self.provider_id: typing.Final = str(uuid.uuid4())
 
     @abc.abstractmethod
     async def async_resolve(self, container: Container) -> T_co:
@@ -27,19 +27,26 @@ class AbstractResolver(typing.Generic[T_co], abc.ABC):
     def sync_resolve(self, container: Container) -> T_co:
         """Resolve dependency synchronously."""
 
-    def override(self, override_object: object, container: Container) -> None:
-        container.override(self.resolver_id, override_object)
-
-    def reset_override(self, container: Container) -> None:
-        container.reset_override(self.resolver_id)
-
     @property
     def cast(self) -> T_co:
         return typing.cast(T_co, self)
 
+    def _check_providers_scope(self, providers: typing.Iterable[typing.Any]) -> None:
+        if any(x.scope > self.scope for x in providers if isinstance(x, AbstractProvider)):
+            msg = "Scope of dependency cannot be more than scope of dependent"
+            raise RuntimeError(msg)
+
+
+class AbstractOverrideProvider(AbstractProvider[T_co], abc.ABC):
+    def override(self, override_object: object, container: Container) -> None:
+        container.override(self.provider_id, override_object)
+
+    def reset_override(self, container: Container) -> None:
+        container.reset_override(self.provider_id)
+
 
-class BaseCreatorResolver(AbstractResolver[T_co], abc.ABC):
-    BASE_SLOTS: typing.ClassVar = [*AbstractResolver.BASE_SLOTS, "_args", "_kwargs", "_creator"]
+class AbstractCreatorProvider(AbstractOverrideProvider[T_co], abc.ABC):
+    BASE_SLOTS: typing.ClassVar = [*AbstractProvider.BASE_SLOTS, "_args", "_kwargs", "_creator"]
 
     def __init__(
         self,
@@ -49,11 +56,7 @@ class BaseCreatorResolver(AbstractResolver[T_co], abc.ABC):
         **kwargs: P.kwargs,
     ) -> None:
         super().__init__(scope)
-
-        if any(x.scope > self.scope for x in itertools.chain(args, kwargs.values()) if isinstance(x, AbstractResolver)):
-            msg = "Scope of dependency cannot be more than scope of dependent"
-            raise RuntimeError(msg)
-
+        self._check_providers_scope(itertools.chain(args, kwargs.values()))
         self._creator: typing.Final = creator
         self._args: typing.Final = args
         self._kwargs: typing.Final = kwargs
@@ -61,12 +64,12 @@ class BaseCreatorResolver(AbstractResolver[T_co], abc.ABC):
     def _sync_build_creator(self, container: Container) -> typing.Any:  # noqa: ANN401
         return self._creator(
             *typing.cast(
-                P.args, [x.sync_resolve(container) if isinstance(x, AbstractResolver) else x for x in self._args]
+                P.args, [x.sync_resolve(container) if isinstance(x, AbstractProvider) else x for x in self._args]
             ),
             **typing.cast(
                 P.kwargs,
                 {
-                    k: v.sync_resolve(container) if isinstance(v, AbstractResolver) else v
+                    k: v.sync_resolve(container) if isinstance(v, AbstractProvider) else v
                     for k, v in self._kwargs.items()
                 },
             ),
@@ -76,12 +79,12 @@ class BaseCreatorResolver(AbstractResolver[T_co], abc.ABC):
         return self._creator(
             *typing.cast(
                 P.args,
-                [await x.async_resolve(container) if isinstance(x, AbstractResolver) else x for x in self._args],
+                [await x.async_resolve(container) if isinstance(x, AbstractProvider) else x for x in self._args],
             ),
             **typing.cast(
                 P.kwargs,
                 {
-                    k: await v.async_resolve(container) if isinstance(v, AbstractResolver) else v
+                    k: await v.async_resolve(container) if isinstance(v, AbstractProvider) else v
                     for k, v in self._kwargs.items()
                 },
             ),

modern_di-0.4.0/modern_di/providers/dict.py

@@ -0,0 +1,23 @@
+import enum
+import typing
+
+from modern_di import Container
+from modern_di.providers.abstract import AbstractProvider
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+
+
+class Dict(AbstractProvider[dict[str, T_co]]):
+    __slots__ = [*AbstractProvider.BASE_SLOTS, "_providers"]
+
+    def __init__(self, scope: enum.IntEnum, **providers: AbstractProvider[T_co]) -> None:
+        super().__init__(scope)
+        self._check_providers_scope(providers.values())
+        self._providers: typing.Final = providers
+
+    async def async_resolve(self, container: Container) -> dict[str, T_co]:
+        return {key: await provider.async_resolve(container) for key, provider in self._providers.items()}
+
+    def sync_resolve(self, container: Container) -> dict[str, T_co]:
+        return {key: provider.sync_resolve(container) for key, provider in self._providers.items()}

{modern_di-0.2.1/modern_di/resolvers → modern_di-0.4.0/modern_di/providers}/factory.py

@@ -2,15 +2,15 @@ import enum
 import typing
 
 from modern_di import Container
-from modern_di.resolvers import BaseCreatorResolver
+from modern_di.providers.abstract import AbstractCreatorProvider
 
 
 T_co = typing.TypeVar("T_co", covariant=True)
 P = typing.ParamSpec("P")
 
 
-class Factory(BaseCreatorResolver[T_co]):
-    __slots__ = [*BaseCreatorResolver.BASE_SLOTS, "_creator"]
+class Factory(AbstractCreatorProvider[T_co]):
+    __slots__ = [*AbstractCreatorProvider.BASE_SLOTS, "_creator"]
 
     def __init__(
         self,
@@ -23,14 +23,14 @@ class Factory(BaseCreatorResolver[T_co]):
 
     async def async_resolve(self, container: Container) -> T_co:
         container = container.find_container(self.scope)
-        if (override := container.fetch_override(self.resolver_id)) is not None:
+        if (override := container.fetch_override(self.provider_id)) is not None:
             return typing.cast(T_co, override)
 
         return typing.cast(T_co, await self._async_build_creator(container))
 
     def sync_resolve(self, container: Container) -> T_co:
         container = container.find_container(self.scope)
-        if (override := container.fetch_override(self.resolver_id)) is not None:
+        if (override := container.fetch_override(self.provider_id)) is not None:
             return typing.cast(T_co, override)
 
         return typing.cast(T_co, self._sync_build_creator(container))

modern_di-0.4.0/modern_di/providers/list.py

@@ -0,0 +1,23 @@
+import enum
+import typing
+
+from modern_di import Container
+from modern_di.providers.abstract import AbstractProvider
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+
+
+class List(AbstractProvider[list[T_co]]):
+    __slots__ = [*AbstractProvider.BASE_SLOTS, "_providers"]
+
+    def __init__(self, scope: enum.IntEnum, *providers: AbstractProvider[T_co]) -> None:
+        super().__init__(scope)
+        self._check_providers_scope(providers)
+        self._providers: typing.Final = providers
+
+    async def async_resolve(self, container: Container) -> list[T_co]:
+        return [await x.async_resolve(container) for x in self._providers]
+
+    def sync_resolve(self, container: Container) -> list[T_co]:
+        return [x.sync_resolve(container) for x in self._providers]

{modern_di-0.2.1/modern_di/resolvers → modern_di-0.4.0/modern_di/providers}/resource.py

@@ -4,15 +4,15 @@ import inspect
 import typing
 
 from modern_di import Container
-from modern_di.resolvers import BaseCreatorResolver
+from modern_di.providers.abstract import AbstractCreatorProvider
 
 
 T_co = typing.TypeVar("T_co", covariant=True)
 P = typing.ParamSpec("P")
 
 
-class Resource(BaseCreatorResolver[T_co]):
-    __slots__ = [*BaseCreatorResolver.BASE_SLOTS, "_creator", "_args", "_kwargs", "_is_async"]
+class Resource(AbstractCreatorProvider[T_co]):
+    __slots__ = [*AbstractCreatorProvider.BASE_SLOTS, "_creator", "_args", "_kwargs", "_is_async"]
 
     def _is_creator_async(
         self,
@@ -42,43 +42,43 @@ class Resource(BaseCreatorResolver[T_co]):
 
     async def async_resolve(self, container: Container) -> T_co:
         container = container.find_container(self.scope)
-        if (override := container.fetch_override(self.resolver_id)) is not None:
+        if (override := container.fetch_override(self.provider_id)) is not None:
             return typing.cast(T_co, override)
 
-        resolver_state = container.fetch_resolver_state(
-            self.resolver_id, is_async_resource=self._is_async, is_lock_required=True
+        provider_state = container.fetch_provider_state(
+            self.provider_id, is_async_resource=self._is_async, is_lock_required=True
         )
-        if resolver_state.instance is not None:
-            return typing.cast(T_co, resolver_state.instance)
+        if provider_state.instance is not None:
+            return typing.cast(T_co, provider_state.instance)
 
-        assert resolver_state.resolver_lock
-        await resolver_state.resolver_lock.acquire()
+        assert provider_state.provider_lock
+        await provider_state.provider_lock.acquire()
 
         try:
-            if resolver_state.instance is not None:
-                return typing.cast(T_co, resolver_state.instance)
+            if provider_state.instance is not None:
+                return typing.cast(T_co, provider_state.instance)
 
             _intermediate_ = await self._async_build_creator(container)
 
             if self._is_creator_async(self._creator):  # type: ignore[arg-type]
-                resolver_state.context_stack = contextlib.AsyncExitStack()
-                resolver_state.instance = await resolver_state.context_stack.enter_async_context(_intermediate_)
+                provider_state.context_stack = contextlib.AsyncExitStack()
+                provider_state.instance = await provider_state.context_stack.enter_async_context(_intermediate_)
             else:
-                resolver_state.context_stack = contextlib.ExitStack()
-                resolver_state.instance = resolver_state.context_stack.enter_context(_intermediate_)
+                provider_state.context_stack = contextlib.ExitStack()
+                provider_state.instance = provider_state.context_stack.enter_context(_intermediate_)
         finally:
-            resolver_state.resolver_lock.release()
+            provider_state.provider_lock.release()
 
-        return typing.cast(T_co, resolver_state.instance)
+        return typing.cast(T_co, provider_state.instance)
 
     def sync_resolve(self, container: Container) -> T_co:
         container = container.find_container(self.scope)
-        if (override := container.fetch_override(self.resolver_id)) is not None:
+        if (override := container.fetch_override(self.provider_id)) is not None:
             return typing.cast(T_co, override)
 
-        resolver_state = container.fetch_resolver_state(self.resolver_id)
-        if resolver_state.instance is not None:
-            return typing.cast(T_co, resolver_state.instance)
+        provider_state = container.fetch_provider_state(self.provider_id)
+        if provider_state.instance is not None:
+            return typing.cast(T_co, provider_state.instance)
 
         if self._is_async:
             msg = "Async resource cannot be resolved synchronously"
@@ -86,9 +86,9 @@ class Resource(BaseCreatorResolver[T_co]):
 
         _intermediate_ = self._sync_build_creator(container)
 
-        resolver_state.context_stack = contextlib.ExitStack()
-        resolver_state.instance = resolver_state.context_stack.enter_context(
+        provider_state.context_stack = contextlib.ExitStack()
+        provider_state.instance = provider_state.context_stack.enter_context(
             typing.cast(contextlib.AbstractContextManager[typing.Any], _intermediate_)
         )
 
-        return typing.cast(T_co, resolver_state.instance)
+        return typing.cast(T_co, provider_state.instance)

modern_di-0.4.0/modern_di/providers/selector.py

@@ -0,0 +1,39 @@
+import enum
+import typing
+
+from modern_di import Container
+from modern_di.providers.abstract import AbstractProvider
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+P = typing.ParamSpec("P")
+
+
+class Selector(AbstractProvider[T_co]):
+    __slots__ = [*AbstractProvider.BASE_SLOTS, "_function", "_providers"]
+
+    def __init__(
+        self, scope: enum.IntEnum, function: typing.Callable[..., str], **providers: AbstractProvider[T_co]
+    ) -> None:
+        super().__init__(scope)
+        self._check_providers_scope(providers.values())
+        self._function: typing.Final = function
+        self._providers: typing.Final = providers
+
+    async def async_resolve(self, container: Container) -> T_co:
+        container = container.find_container(self.scope)
+        selected_key = self._function(**container.context)
+        if selected_key not in self._providers:
+            msg = f"No provider matches {selected_key}"
+            raise RuntimeError(msg)
+
+        return await self._providers[selected_key].async_resolve(container)
+
+    def sync_resolve(self, container: Container) -> T_co:
+        container = container.find_container(self.scope)
+        selected_key = self._function(**container.context)
+        if selected_key not in self._providers:
+            msg = f"No provider matches {selected_key}"
+            raise RuntimeError(msg)
+
+        return self._providers[selected_key].sync_resolve(container)