python-injection 0.9.0__py3-none-any.whl → 0.9.1__py3-none-any.whl

injection/__init__.py

@@ -7,7 +7,6 @@ __all__ = (
     "InjectableMode",
     "Module",
     "ModulePriority",
-    "default_module",
     "get_instance",
     "get_lazy_instance",
     "inject",
@@ -17,12 +16,14 @@ __all__ = (
     "singleton",
 )
 
-default_module = Module(f"{__name__}:default_module")
+_module = Module.default()
 
-get_instance = default_module.get_instance
-get_lazy_instance = default_module.get_lazy_instance
-inject = default_module.inject
-injectable = default_module.injectable
-set_constant = default_module.set_constant
-should_be_injectable = default_module.should_be_injectable
-singleton = default_module.singleton
+get_instance = _module.get_instance
+get_lazy_instance = _module.get_lazy_instance
+inject = _module.inject
+injectable = _module.injectable
+set_constant = _module.set_constant
+should_be_injectable = _module.should_be_injectable
+singleton = _module.singleton
+
+del _module

injection/__init__.pyi

@@ -6,7 +6,6 @@ from types import UnionType
 from typing import (
     Any,
     ContextManager,
-    Final,
     Protocol,
     Self,
     final,
@@ -19,15 +18,17 @@ from .core import InjectableFactory
 from .core import ModeStr as InjectableModeStr
 from .core import PriorityStr as ModulePriorityStr
 
-default_module: Final[Module] = ...
+_module: Module = ...
 
-get_instance = default_module.get_instance
-get_lazy_instance = default_module.get_lazy_instance
-inject = default_module.inject
-injectable = default_module.injectable
-set_constant = default_module.set_constant
-should_be_injectable = default_module.should_be_injectable
-singleton = default_module.singleton
+get_instance = _module.get_instance
+get_lazy_instance = _module.get_lazy_instance
+inject = _module.inject
+injectable = _module.injectable
+set_constant = _module.set_constant
+should_be_injectable = _module.should_be_injectable
+singleton = _module.singleton
+
+del _module
 
 @final
 class Module:
@@ -178,6 +179,18 @@ class Module:
         Function to unlock the module by deleting cached instances of singletons.
         """
 
+    @classmethod
+    def from_name(cls, name: str) -> Self:
+        """
+        Class method for getting or creating a module by name.
+        """
+
+    @classmethod
+    def default(cls) -> Self:
+        """
+        Class method for getting the default module.
+        """
+
 @final
 class ModulePriority(StrEnum):
     LOW = ...

injection/common/tools/threading.py

@@ -6,5 +6,7 @@ __all__ = ("synchronized",)
 
 @contextmanager
 def synchronized():
-    with RLock():
-        yield
+    lock = RLock()
+
+    with lock:
+        yield lock

injection/common/tools/type.py

@@ -21,11 +21,13 @@ class TypeReport[T](NamedTuple):
     args: tuple[Any, ...]
 
     @property
-    def cls(self) -> type[T]:
-        if self.args:
-            return self.origin[*self.args]
+    def type(self) -> type[T]:
+        origin = self.origin
+
+        if args := self.args:
+            return origin[*args]
 
-        return self.origin
+        return origin
 
     @property
     def no_args(self) -> Self:

injection/core/module.py

@@ -78,10 +78,10 @@ class ContainerDependenciesUpdated(ContainerEvent):
 
     def __str__(self) -> str:
         length = len(self.reports)
-        formatted_classes = ", ".join(f"`{report.cls}`" for report in self.reports)
+        formatted_types = ", ".join(f"`{report.type}`" for report in self.reports)
         return (
-            f"{length} container dependenc{'ies' if length > 1 else 'y'} have been "
-            f"updated{f': {formatted_classes}' if formatted_classes else ''}."
+            f"{length} container dependenc{'ies' if length > 1 else 'y'} have "
+            f"been updated{f': {formatted_types}' if formatted_types else ''}."
         )
 
 
@@ -174,7 +174,7 @@ class NewInjectable[T](BaseInjectable[T]):
 class SingletonInjectable[T](BaseInjectable[T]):
     __slots__ = ("__dict__",)
 
-    __INSTANCE_KEY: ClassVar[str] = "$instance"
+    __key: ClassVar[str] = "$instance"
 
     @property
     def cache(self) -> MutableMapping[str, Any]:
@@ -182,18 +182,18 @@ class SingletonInjectable[T](BaseInjectable[T]):
 
     @property
     def is_locked(self) -> bool:
-        return self.__INSTANCE_KEY in self.cache
+        return self.__key in self.cache
 
     def unlock(self):
         self.cache.clear()
 
     def get_instance(self) -> T:
         with suppress(KeyError):
-            return self.cache[self.__INSTANCE_KEY]
+            return self.cache[self.__key]
 
         with synchronized():
             instance = self.factory()
-            self.cache[self.__INSTANCE_KEY] = instance
+            self.cache[self.__key] = instance
 
         return instance
 
@@ -340,7 +340,7 @@ class Container(Broker):
             else:
                 if mode == current_mode and mode != Mode.OVERRIDE:
                     raise RuntimeError(
-                        f"An injectable already exists for the class `{report.cls}`."
+                        f"An injectable already exists for the class `{report.type}`."
                     )
 
                 elif rank < current_mode.rank:
@@ -368,16 +368,27 @@ type PriorityStr = Literal["low", "high"]
 type InjectableFactory[T] = Callable[[Callable[..., T]], Injectable[T]]
 
 
-@dataclass(repr=False, eq=False, frozen=True, slots=True)
+@dataclass(eq=False, frozen=True, slots=True)
 class Module(EventListener, Broker):
     name: str | None = field(default=None)
-    __channel: EventChannel = field(default_factory=EventChannel, init=False)
-    __container: Container = field(default_factory=Container, init=False)
+    __channel: EventChannel = field(
+        default_factory=EventChannel,
+        init=False,
+        repr=False,
+    )
+    __container: Container = field(
+        default_factory=Container,
+        init=False,
+        repr=False,
+    )
     __modules: OrderedDict[Module, None] = field(
         default_factory=OrderedDict,
         init=False,
+        repr=False,
     )
 
+    __instances: ClassVar[dict[str, Module]] = {}
+
     def __post_init__(self):
         self.__container.add_listener(self)
 
@@ -394,9 +405,6 @@ class Module(EventListener, Broker):
     def __contains__(self, cls: type | UnionType, /) -> bool:
         return any(cls in broker for broker in self.__brokers)
 
-    def __str__(self) -> str:
-        return self.name or object.__str__(self)
-
     @property
     def is_locked(self) -> bool:
         return any(broker.is_locked for broker in self.__brokers)
@@ -468,7 +476,7 @@ class Module(EventListener, Broker):
 
             function = InjectedFunction(wp)
 
-            @function.on_setup
+            @function.on_setup(block=False)
             def listen():
                 function.update(self)
                 self.add_listener(function)
@@ -611,6 +619,19 @@ class Module(EventListener, Broker):
                 f"`{module}` can't be found in the modules used by `{self}`."
             ) from exc
 
+    @classmethod
+    def from_name(cls, name: str) -> Self:
+        with suppress(KeyError):
+            return cls.__instances[name]
+
+        instance = cls(name)
+        cls.__instances[name] = instance
+        return instance
+
+    @classmethod
+    def default(cls) -> Self:
+        return cls.from_name("default")
+
 
 """
 InjectedFunction
@@ -641,7 +662,7 @@ class Dependencies:
 
     @classmethod
     def from_mapping(cls, mapping: Mapping[str, Injectable]) -> Self:
-        return cls(mapping=mapping)
+        return cls(mapping)
 
     @classmethod
     def empty(cls) -> Self:
@@ -775,9 +796,9 @@ class InjectedFunction(EventListener):
         self.__dependencies = Dependencies.resolve(self.signature, module, self.__owner)
         return self
 
-    def on_setup(self, wrapped: Callable[[], Any] = None, /):
+    def on_setup(self, wrapped: Callable[[], Any] = None, /, *, block: bool = True):
         def decorator(wp):
-            self.__setup_queue.put(wp)
+            self.__setup_queue.put(wp, block=block)
             return wp
 
         return decorator(wrapped) if wrapped else decorator

injection/integrations/blacksheep.py

@@ -2,7 +2,7 @@ from typing import Any
 
 from rodi import ContainerProtocol
 
-from injection import Module, default_module
+from injection import Module
 
 __all__ = ("InjectionServices",)
 
@@ -14,8 +14,8 @@ class InjectionServices(ContainerProtocol):
 
     __slots__ = ("__module",)
 
-    def __init__(self, module: Module = default_module):
-        self.__module = module
+    def __init__(self, module: Module = None):
+        self.__module = module or Module.default()
 
     def __contains__(self, item: Any) -> bool:
         return item in self.__module

injection/testing/__init__.py

@@ -0,0 +1,38 @@
+from contextlib import contextmanager
+
+from injection import Module, ModulePriority
+
+__all__ = (
+    "set_test_constant",
+    "should_be_test_injectable",
+    "test_injectable",
+    "test_singleton",
+    "use_test_injectables",
+)
+
+
+def get_test_module() -> Module:
+    return Module.from_name("testing")
+
+
+_module = get_test_module()
+
+set_test_constant = _module.set_constant
+should_be_test_injectable = _module.should_be_injectable
+test_injectable = _module.injectable
+test_singleton = _module.singleton
+
+del _module
+
+
+@contextmanager
+def use_test_injectables(*, on: Module = None, test_module: Module = None):
+    on = on or Module.default()
+    test_module = test_module or get_test_module()
+
+    for module in (on, test_module):
+        module.unlock()
+
+    with on.use_temporarily(test_module, priority=ModulePriority.HIGH):
+        yield
+        on.unlock()

injection/testing/__init__.pyi

@@ -0,0 +1,22 @@
+from contextlib import ContextDecorator
+from typing import ContextManager
+
+from injection import Module
+
+_module: Module = ...
+
+set_test_constant = _module.set_constant
+should_be_test_injectable = _module.should_be_injectable
+test_injectable = _module.injectable
+test_singleton = _module.singleton
+
+del _module
+
+def use_test_injectables(
+    *,
+    on: Module = ...,
+    test_module: Module = ...,
+) -> ContextManager | ContextDecorator:
+    """
+    Context manager or decorator for temporary use test module.
+    """

{python_injection-0.9.0.dist-info → python_injection-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-injection
-Version: 0.9.0
+Version: 0.9.1
 Summary: Fast and easy dependency injection framework.
 Home-page: https://github.com/100nm/python-injection
 License: MIT
@@ -15,7 +15,7 @@ Description-Content-Type: text/markdown
 
 # Basic usage
 
-## Create an injectable
+## Register an injectable
 
 > **Note**: If the class needs dependencies, these will be resolved when the instance is retrieved.
 

python_injection-0.9.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+injection/__init__.py,sha256=LhfwYFMBw6tJ7XA_C353w61OPt4IuQQgs3zIjrwMIz8,654
+injection/__init__.pyi,sha256=dfIQAR8L8Yr7dM-DODR4czwUd2a7zzFQHzb8mr1Q6P0,6235
+injection/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/common/event.py,sha256=5Rdb2m3vAMCic8cQAVkStJDbrDrW_lk6kav8wYwmexM,1283
+injection/common/invertible.py,sha256=noNcmJ96IQi0XJms0dyfrx_AvKZnQM0sZyxhc2l6qo0,527
+injection/common/lazy.py,sha256=FEas6ewwOGWvRR8cflmyVvSLZd_-Fxd0QeIdvAM5I9c,1313
+injection/common/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/common/tools/threading.py,sha256=HlvP6k_-eZaK8JbB2b9PP171IZVe_0W2oMYsw3ebdKA,187
+injection/common/tools/type.py,sha256=ThM3Z1_gHmsdT4Jp7PlZgJY0lsufc4InPO65485Ugsg,1739
+injection/core/__init__.py,sha256=zuf0ubI2dHnbjn1059eduhS-ACIkkROa6-dhp10krh0,22
+injection/core/module.py,sha256=3FqU4XQgTNLI-VwpX1bKcRsLOaPeKSQ0sQuVsL_27I4,21625
+injection/exceptions.py,sha256=RsWWiWwKSMU0vxXQqQSn6CKHLMrGu4SSzYUAy9OJRXk,626
+injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/integrations/blacksheep.py,sha256=82P_owhF3FKIJxxalnSic3AJnoOr1mkojkWMefpO6QI,731
+injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/testing/__init__.py,sha256=xglKmIJgg2j1wt8qWJ_TtGfFyKmn7xE7b8kQhD2yEkQ,864
+injection/testing/__init__.pyi,sha256=_u95cJVHBkt69HUvnu2bbfYWmi7GOH_1qyFyvC1PxBk,518
+injection/utils.py,sha256=_79aiciimZpuoUTz5lojKySUMMzpkU-e7SotiHIFTI8,676
+python_injection-0.9.1.dist-info/METADATA,sha256=6vDRDhsWCG-FbwiHs-pvslfia8Fpe2n7hWJPoxJJbhg,3572
+python_injection-0.9.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+python_injection-0.9.1.dist-info/RECORD,,

python_injection-0.9.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-injection/__init__.py,sha256=Bf6S99E2srD3752xlJf3uAdiGIzY2YHOZafcwEiwY70,739
-injection/__init__.pyi,sha256=HEk1HXAmwtq2ZEFLf5A7VWhdpPVWVQpjsLip9JzepEY,6023
-injection/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/common/event.py,sha256=5Rdb2m3vAMCic8cQAVkStJDbrDrW_lk6kav8wYwmexM,1283
-injection/common/invertible.py,sha256=noNcmJ96IQi0XJms0dyfrx_AvKZnQM0sZyxhc2l6qo0,527
-injection/common/lazy.py,sha256=FEas6ewwOGWvRR8cflmyVvSLZd_-Fxd0QeIdvAM5I9c,1313
-injection/common/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/common/tools/threading.py,sha256=Urcy59Rp34psRWmzzQyNDu4Zm-DuCkPsp4qO1x_W4qQ,165
-injection/common/tools/type.py,sha256=5Ixswd9-sSqJdmh9lTd3jADFHWgD0wZSwecVi1opeO0,1715
-injection/core/__init__.py,sha256=zuf0ubI2dHnbjn1059eduhS-ACIkkROa6-dhp10krh0,22
-injection/core/module.py,sha256=nCa10YQu-o-W0jMt-EnjCuXc1VioqN5CZXK2EoS4zgo,21241
-injection/exceptions.py,sha256=RsWWiWwKSMU0vxXQqQSn6CKHLMrGu4SSzYUAy9OJRXk,626
-injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/integrations/blacksheep.py,sha256=GQBZCyl_DNDuCJdV56EYaiYCXGDMmP66cEahRzUZpmc,737
-injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/utils.py,sha256=_79aiciimZpuoUTz5lojKySUMMzpkU-e7SotiHIFTI8,676
-python_injection-0.9.0.dist-info/METADATA,sha256=j_ikavu9sPJ2xkKcX6Vr8MmhoNayLEiVNLPQ99TzWNY,3570
-python_injection-0.9.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-python_injection-0.9.0.dist-info/RECORD,,