python-injection 0.10.12.post0__py3-none-any.whl → 0.11.0__py3-none-any.whl

injection/__init__.py

@@ -1,7 +1,9 @@
+from ._core.descriptors import LazyInstance
 from ._core.module import Injectable, Mode, Module, Priority
 
 __all__ = (
     "Injectable",
+    "LazyInstance",
     "Mode",
     "Module",
     "Priority",

injection/__init__.pyi

@@ -9,6 +9,7 @@ from typing import (
     Protocol,
     Self,
     final,
+    overload,
     runtime_checkable,
 )
 
@@ -136,23 +137,31 @@ class Module:
         parameter or an exception will be raised.
         """
 
+    @overload
     def get_instance[T, Default](
         self,
         cls: _InputType[T],
-        default: Default | None = ...,
-    ) -> T | Default | None:
+        default: Default,
+    ) -> T | Default:
         """
         Function used to retrieve an instance associated with the type passed in
         parameter or return `None`.
         """
 
+    @overload
+    def get_instance[T, _](
+        self,
+        cls: _InputType[T],
+        default: None = ...,
+    ) -> T | None: ...
+    @overload
     def get_lazy_instance[T, Default](
         self,
         cls: _InputType[T],
-        default: Default | None = ...,
+        default: Default,
         *,
         cache: bool = ...,
-    ) -> _Invertible[T | Default | None]:
+    ) -> _Invertible[T | Default]:
         """
         Function used to retrieve an instance associated with the type passed in
         parameter or `None`. Return a `Invertible` object. To access the instance
@@ -162,6 +171,14 @@ class Module:
         Example: instance = ~lazy_instance
         """
 
+    @overload
+    def get_lazy_instance[T, _](
+        self,
+        cls: _InputType[T],
+        default: None = ...,
+        *,
+        cache: bool = ...,
+    ) -> _Invertible[T | None]: ...
     def init_modules(self, *modules: Module) -> Self:
         """
         Function to clean modules in use and to use those passed as parameters.
@@ -243,3 +260,10 @@ class Mode(Enum):
     FALLBACK = ...
     NORMAL = ...
     OVERRIDE = ...
+
+class LazyInstance[T]:
+    def __init__(self, cls: _InputType[T], module: Module = ...) -> None: ...
+    @overload
+    def __get__(self, instance: object, owner: type | None = ...) -> T: ...
+    @overload
+    def __get__(self, instance: None = ..., owner: type | None = ...) -> Self: ...

injection/_core/descriptors.py

@@ -0,0 +1,25 @@
+from typing import Self
+
+from injection._core.common.invertible import Invertible
+from injection._core.common.type import InputType
+from injection._core.module import Module
+
+
+class LazyInstance[T]:
+    __slots__ = ("__value",)
+
+    __value: Invertible[T]
+
+    def __init__(self, cls: InputType[T], module: Module | None = None) -> None:
+        module = module or Module.default()
+        self.__value = module.get_lazy_instance(cls, default=NotImplemented)  # type: ignore[assignment]
+
+    def __get__(
+        self,
+        instance: object | None = None,
+        owner: type | None = None,
+    ) -> Self | T:
+        if instance is None:
+            return self
+
+        return ~self.__value

injection/integrations/fastapi.py

@@ -1,6 +1,6 @@
 from collections.abc import Callable
 from types import GenericAlias
-from typing import Any, ClassVar, TypeAliasType
+from typing import Any, TypeAliasType
 
 from injection import Module, mod
 from injection.exceptions import InjectionError
@@ -34,10 +34,8 @@ class InjectionDependency[T]:
     __class: type[T] | TypeAliasType | GenericAlias
     __module: Module
 
-    __sentinel: ClassVar[object] = object()
-
     def __init__(self, cls: type[T] | TypeAliasType | GenericAlias, module: Module):
-        lazy_instance = module.get_lazy_instance(cls, default=self.__sentinel)
+        lazy_instance = module.get_lazy_instance(cls, default=NotImplemented)
         self.__call__ = lambda: self.__ensure(~lazy_instance)
         self.__class = cls
         self.__module = module
@@ -55,8 +53,8 @@ class InjectionDependency[T]:
     def __key(self) -> tuple[type[T] | TypeAliasType | GenericAlias, Module]:
         return self.__class, self.__module
 
-    def __ensure(self, instance: T | Any) -> T:
-        if instance is self.__sentinel:
+    def __ensure(self, instance: T) -> T:
+        if instance is NotImplemented:
             raise InjectionError(f"`{self.__class}` is an unknown dependency.")
 
         return instance

injection/testing/__init__.py

@@ -21,5 +21,5 @@ test_injectable = mod(_TEST_PROFILE_NAME).injectable
 test_singleton = mod(_TEST_PROFILE_NAME).singleton
 
 
-def load_test_profile(*other_profile_names: str) -> ContextManager[None]:
-    return load_profile(_TEST_PROFILE_NAME, *other_profile_names)
+def load_test_profile(*names: str) -> ContextManager[None]:
+    return load_profile(_TEST_PROFILE_NAME, *names)

injection/utils.py

@@ -10,13 +10,13 @@ from injection import mod
 __all__ = ("load_packages", "load_profile")
 
 
-def load_profile(name: str, /, *other_profile_names: str) -> ContextManager[None]:
+def load_profile(*names: str) -> ContextManager[None]:
     """
     Injection module initialization function based on profile name.
     A profile name is equivalent to an injection module name.
     """
 
-    modules = tuple(mod(module_name) for module_name in (name, *other_profile_names))
+    modules = tuple(mod(module_name) for module_name in names)
 
     for module in modules:
         module.unlock()

{python_injection-0.10.12.post0.dist-info → python_injection-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-injection
-Version: 0.10.12.post0
+Version: 0.11.0
 Summary: Fast and easy dependency injection framework.
 Home-page: https://github.com/100nm/python-injection
 License: MIT

{python_injection-0.10.12.post0.dist-info → python_injection-0.11.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-injection/__init__.py,sha256=6zHo40kXRsCruG23gMllEymAQ3crQkE_8Q-wV78iomU,769
-injection/__init__.pyi,sha256=kYMUV96CusOcz9RvkgQiii0QaKwWz8160qeJ3mrwPgY,7308
+injection/__init__.py,sha256=4JWr0tMlFJb6Tz2Qsd7AupLiMh13XzleBtViJlWgdZA,833
+injection/__init__.pyi,sha256=Tj6p9OonN4YEXvjswPSFOCSf6Eq3MidhBHR8ewuFc2w,7927
 injection/_core/__init__.py,sha256=VMGLfdu0gYh82mt7zS297rQ7CE_gHVy0gRdI8RY_ZLY,1361
 injection/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/common/event.py,sha256=kev8WUESAXzMn11EJsbTcICaCvYiD556E6BOLvQ54s4,1243
@@ -7,16 +7,17 @@ injection/_core/common/invertible.py,sha256=QYXMqLrkAkz_7mq-jEYKtBr1CQ5aqzplP0FG
 injection/_core/common/lazy.py,sha256=kCO1q4S6AdBhsP5RrihBJpgfeR4hxvMqSz1cpCgBdjo,1482
 injection/_core/common/threading.py,sha256=OXm7L3p8c7O7eSkU-RTR7cobqIGMhuo-7gpDXsWKDNQ,214
 injection/_core/common/type.py,sha256=TQTD-f_rnAHS0VgfkWxNFU8HAWPvkAktNDQ9_23JLHM,1705
+injection/_core/descriptors.py,sha256=1DxrJpUXK2exSLAmdMHLNRRn7EBhQyu_vVvrchif2sw,696
 injection/_core/hook.py,sha256=_TcwhF_DONfcoBz58RxVLeA950Rs8wtZSLGepZwGBRk,3009
 injection/_core/module.py,sha256=zvYqUIAV9saTYGBuKbR4tNk2AFrMxyFxNPmvMMmKoe4,25300
 injection/exceptions.py,sha256=-5Shs7R5rctQXhpMLfcjiMBCzrtFWxC88qETUIHz57s,692
 injection/integrations/__init__.py,sha256=NYLcstr4ESdLj326LlDub143z6JGM1z1pCOVWhBXK10,304
 injection/integrations/blacksheep.py,sha256=yO5gLb_l4W3bNPFt-v2qWIL9R8PNon4JmOxQEHdi-5o,923
-injection/integrations/fastapi.py,sha256=GIxpSOumBQ8r8ihBVAzbp0nd68x8YWh6zSfL7d6QLWs,1786
+injection/integrations/fastapi.py,sha256=j5ASbMszua-Ti9A_dgFO629RjSIzIVbck78Ymz6CiTo,1723
 injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/testing/__init__.py,sha256=-C38gmZJwDtLDAWJhqiaosOZWQZwwFa1M34tODcrASs,747
+injection/testing/__init__.py,sha256=Wd9sq43CJCV7GjYFSIaikIf4hJ5lfVNS7GP3iI8a1X8,719
 injection/testing/__init__.pyi,sha256=6ZXbbS-9ppMdkxd03I6yBNurmR3Xw7sM_qiokibkLeY,386
-injection/utils.py,sha256=gPcxGIdrGz4irbJXGTYPw33jNy8jg56u_c61eb1MBSE,1971
-python_injection-0.10.12.post0.dist-info/METADATA,sha256=j-HFgbGdjn5FcPPiMuDYQc86HKuT9-r57CWa-xIkNFs,3117
-python_injection-0.10.12.post0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-python_injection-0.10.12.post0.dist-info/RECORD,,
+injection/utils.py,sha256=79VoIgxO1MNb_FlfRRbzfx3RXX3DPDtoxMgngfmNF-Q,1920
+python_injection-0.11.0.dist-info/METADATA,sha256=whi_71OOame5OSWStDfKMvHxCXQjmKhgCybFhe2WA7s,3110
+python_injection-0.11.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+python_injection-0.11.0.dist-info/RECORD,,