python-injection 0.25.15__py3-none-any.whl → 0.26.0__py3-none-any.whl

injection/__init__.pyi

@@ -68,6 +68,7 @@ def mod(name: str = ..., /) -> Module:
     """
     Short syntax for `Module.from_name`.
     """
+
 @runtime_checkable
 class Injectable[T](Protocol):
     @property
@@ -234,9 +235,8 @@ class Module:
     ) -> _Decorator: ...
     def scoped(
         self,
-        scope_name: str,
         /,
-        *,
+        *scope_names: str,
         ignore_type_hint: bool = ...,
         inject: bool = ...,
         on: _TypeInfo[Any] = ...,

injection/_core/injectables.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from collections.abc import Awaitable, Callable, MutableMapping
+from collections.abc import Awaitable, Callable, MutableMapping, Sequence
 from contextlib import suppress
 from dataclasses import dataclass, field
 from functools import partial
@@ -16,7 +16,7 @@ from typing import (
 
 from injection._core.common.asynchronous import AsyncSemaphore, Caller
 from injection._core.common.type import InputType
-from injection._core.scope import Scope, get_scope, in_scope_cache
+from injection._core.scope import Scope, get_first_scope, in_scope_cache
 from injection._core.slots import SlotKey
 from injection.exceptions import EmptySlotError, InjectionError
 
@@ -129,13 +129,13 @@ class ConstantInjectable[T](Injectable[T]):
 @dataclass(repr=False, eq=False, frozen=True, slots=True)
 class ScopedInjectable[R, T](Injectable[T], ABC):
     factory: Caller[..., R]
-    scope_name: str
+    scope_names: Sequence[str]
     key: SlotKey[T] = field(default_factory=SlotKey)
     logic: CacheLogic[T] = field(default_factory=CacheLogic)
 
     @property
     def is_locked(self) -> bool:
-        return in_scope_cache(self.key, self.scope_name)
+        return in_scope_cache(self.key, *self.scope_names)
 
     @abstractmethod
     async def abuild(self, scope: Scope) -> T:
@@ -157,14 +157,16 @@ class ScopedInjectable[R, T](Injectable[T], ABC):
 
     def unlock(self) -> None:
         if self.is_locked:
-            raise RuntimeError(f"To unlock, close the `{self.scope_name}` scope.")
+            raise RuntimeError(
+                f"To unlock, close all open scopes in [{', '.join(f'`{name}`' for name in self.scope_names)}]."
+            )
 
     def __get_scope(self) -> Scope:
-        return get_scope(self.scope_name)
+        return get_first_scope(*self.scope_names)
 
     @classmethod
-    def bind_scope_name(cls, name: str) -> Callable[[Caller[..., R]], Self]:
-        return partial(cls, scope_name=name)
+    def bind_scope_names(cls, names: Sequence[str]) -> Callable[[Caller[..., R]], Self]:
+        return partial(cls, scope_names=names)
 
 
 class AsyncCMScopedInjectable[T](ScopedInjectable[AsyncContextManager[T], T]):
@@ -211,7 +213,7 @@ class ScopedSlotInjectable[T](Injectable[T]):
 
     def get_instance(self) -> T:
         scope_name = self.scope_name
-        scope = get_scope(scope_name)
+        scope = get_first_scope(scope_name)
 
         try:
             return scope.cache[self.key]

injection/_core/module.py

@@ -250,9 +250,8 @@ class Module(EventListener, InjectionProvider):  # type: ignore[misc]
 
     def scoped[**P, T](
         self,
-        scope_name: str,
         /,
-        *,
+        *scope_names: str,
         ignore_type_hint: bool = False,
         inject: bool = True,
         on: TypeInfo[T] = (),
@@ -284,7 +283,7 @@ class Module(EventListener, InjectionProvider):  # type: ignore[misc]
 
             self.injectable(
                 ctx.wrapper,
-                cls=ctx.cls.bind_scope_name(scope_name),
+                cls=ctx.cls.bind_scope_names(scope_names),
                 ignore_type_hint=True,
                 inject=inject,
                 on=(*ctx.hints, on),

injection/_core/scope.py

@@ -151,34 +151,36 @@ def define_scope(
 if TYPE_CHECKING:  # pragma: no cover
 
     @overload
-    def get_scope(name: str, default: EllipsisType = ...) -> Scope: ...
+    def get_first_scope(*names: str, default: EllipsisType = ...) -> Scope: ...
 
     @overload
-    def get_scope[T](name: str, default: T) -> Scope | T: ...
+    def get_first_scope[T](*names: str, default: T) -> Scope | T: ...
 
 
-def get_scope[T](name: str, default: T | EllipsisType = ...) -> Scope | T:
+def get_first_scope[T](*names: str, default: T | EllipsisType = ...) -> Scope | T:
     for resolvers in __scope_resolvers.values():
-        resolver = resolvers.get(name)
-        if resolver and (scope := resolver.get_scope()):
-            return scope
+        for name in names:
+            resolver = resolvers.get(name)
+            if resolver and (scope := resolver.get_scope()):
+                return scope
 
     if default is ...:
         raise ScopeUndefinedError(
-            f"Scope `{name}` isn't defined in the current context."
+            f"No scope in [{', '.join(f'`{name}`' for name in names)}] is defined in the current context."
         )
 
     return default
 
 
-def in_scope_cache(key: SlotKey[Any], scope_name: str) -> bool:
-    return any(key in scope.cache for scope in iter_active_scopes(scope_name))
+def in_scope_cache(key: SlotKey[Any], *scope_names: str) -> bool:
+    return any(key in scope.cache for scope in iter_active_scopes(*scope_names))
 
 
-def iter_active_scopes(name: str) -> Iterator[Scope]:
+def iter_active_scopes(*names: str) -> Iterator[Scope]:
     active_scopes = (
         resolver.active_scopes
         for resolvers in __scope_resolvers.values()
+        for name in names
         if (resolver := resolvers.get(name))
     )
     return itertools.chain.from_iterable(active_scopes)
@@ -194,7 +196,7 @@ def _bind_scope(
     lock = get_lock(threadsafe)
 
     with lock:
-        if get_scope(name, None):
+        if get_first_scope(name, default=None):
             raise ScopeAlreadyDefinedError(
                 f"Scope `{name}` is already defined in the current context."
             )

{python_injection-0.25.15.dist-info → python_injection-0.26.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.25.15
+Version: 0.26.0
 Summary: Dead-simple dependency injection framework for Python.
 Project-URL: Documentation, https://python-injection.remimd.dev
 Project-URL: Repository, https://github.com/100nm/python-injection

{python_injection-0.25.15.dist-info → python_injection-0.26.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 injection/__init__.py,sha256=8nYCdToksoBIRTiJFrEbAUa_g8--dFL--4pfSGlGDP4,1350
-injection/__init__.pyi,sha256=GiGUBIkMhqN-TXEH_7iFrD8iQShIWwMXXyIcgSuGsfM,13667
+injection/__init__.pyi,sha256=XzOmrlk_6HNAiQVU4aUDoy3414enMaKTNPpKpXHLYyI,13659
 injection/entrypoint.py,sha256=SjviVj8ajEybGsZ_hmm_NkPIHrIOTmnt3Uhg_GAQJ-s,6709
 injection/exceptions.py,sha256=v57yMujiq6H_zwwn30A8UYEZX9R9k-bY8FnsdaimPM4,1025
 injection/loaders.py,sha256=gBwEfmR1ZHybD2hdtVr-ji6HZS7gCQvgajoiatmZpeM,7394
@@ -7,10 +7,10 @@ injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/asfunction.py,sha256=GY228WHQWvA-9rg3unR8ttyIJlhwxy0bC3LUO5K8Erg,1864
 injection/_core/descriptors.py,sha256=wpW6lFz7ZDDOh1Vc7P86z49UkZ1lajBReWOagSotWDs,3574
-injection/_core/injectables.py,sha256=eMrM_e9kFZIS8GkPZxBU1TMgehJ9Nw3hsnn9yonB_0A,6303
+injection/_core/injectables.py,sha256=t_A-tP7kNmNgjXUX_TKwZj3NU65RDpMUTqkVtvXGVNw,6435
 injection/_core/locator.py,sha256=pff_amjMi0XNXdIcPG8fK3vefRPwVLiZVvFg0qwEvDg,8258
-injection/_core/module.py,sha256=yc2fdgo-H8aY8FtYyaFMn_4vZbG-iFoRzK-e6m7GFjY,28736
-injection/_core/scope.py,sha256=FzR8msxnOjvr-uCVgqP71dCybxYstMJg207QvtRJ3HY,8369
+injection/_core/module.py,sha256=AJgAtoYmAzpCXMiazk2mlyW1aAiGuHK5XcvC5Vf-Ibo,28729
+injection/_core/scope.py,sha256=959UhEt1zY2lstP7zJgQJPGMv4s2fdv0gRL4f47GqRM,8517
 injection/_core/slots.py,sha256=g9TG6CbqRzCsjg01iPyfRtTTUCJnnJOwcj9mJabH0dc,37
 injection/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/common/asynchronous.py,sha256=nKY2_PAMFF2haC75Fwp8O9Zd-SDuenE6n3B-KccwXlw,1772
@@ -24,7 +24,7 @@ injection/ext/fastapi.py,sha256=wpiNyHKEPwQ7sAJt30XpkgiCi4-gfmyqkQWw9BejXwg,1633
 injection/ext/fastapi.pyi,sha256=HLs7mfruIEFRrN_Xf8oCvSa4qwHWfwm6HHU_KMedXkE,185
 injection/testing/__init__.py,sha256=ZWMacZuGhK8Edq1L0Ng0PaRlgKXEunyFZkFvx7-IYIQ,935
 injection/testing/__init__.pyi,sha256=ZFQMUZmvBVkV6Ch7jiYE9zeJhnqHAQnt3vWQ1Th0zDk,646
-python_injection-0.25.15.dist-info/METADATA,sha256=O464FeMesuE4NlQN_OQI8BaEUaoBJ88ItAN1Ww17Zrc,3652
-python_injection-0.25.15.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-python_injection-0.25.15.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
-python_injection-0.25.15.dist-info/RECORD,,
+python_injection-0.26.0.dist-info/METADATA,sha256=FzRj240iIOWO8HPpTxuAbpEYm-tmBkLHLRbADuoGQJw,3651
+python_injection-0.26.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_injection-0.26.0.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
+python_injection-0.26.0.dist-info/RECORD,,

{python_injection-0.25.15.dist-info → python_injection-0.26.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.29.0
 Root-Is-Purelib: true
 Tag: py3-none-any