python-injection 0.10.4__py3-none-any.whl → 0.10.5__py3-none-any.whl

injection/_core/hook.py

@@ -2,7 +2,7 @@ import itertools
 from collections.abc import Callable, Generator, Iterator
 from dataclasses import dataclass, field
 from inspect import isclass, isgeneratorfunction
-from typing import Self
+from typing import Any, Self
 
 from injection.exceptions import HookError
 
@@ -48,11 +48,11 @@ class Hook[**P, T]:
         handler: Callable[P, T],
         function: HookFunction[P, T],
     ) -> Callable[P, T]:
-        if not isgeneratorfunction(function):
+        if not cls.__is_generator_function(function):
             return function  # type: ignore[return-value]
 
         def wrapper(*args: P.args, **kwargs: P.kwargs) -> T:
-            hook = function(*args, **kwargs)
+            hook: HookGenerator[T] = function(*args, **kwargs)  # type: ignore[assignment]
 
             try:
                 next(hook)
@@ -87,6 +87,14 @@ class Hook[**P, T]:
 
         return handler
 
+    @staticmethod
+    def __is_generator_function(obj: Any) -> bool:
+        for o in obj, getattr(obj, "__call__", None):
+            if isgeneratorfunction(o):
+                return True
+
+        return False
+
 
 def apply_hooks[**P, T](
     handler: Callable[P, T],

injection/integrations/__init__.py

@@ -0,0 +1,11 @@
+from importlib.util import find_spec
+from typing import Literal
+
+__all__ = ("_is_installed",)
+
+
+def _is_installed(package: str, needed_for: object, /) -> Literal[True]:
+    if find_spec(package) is None:
+        raise RuntimeError(f"To use `{needed_for}`, {package} must be installed.")
+
+    return True

injection/integrations/blacksheep.py

@@ -1,15 +1,11 @@
 from typing import Any, override
 
 from injection import Module, mod
+from injection.integrations import _is_installed
 
 __all__ = ("InjectionServices",)
 
-
-try:
-    import blacksheep  # noqa: F401
-except ImportError as exc:  # pragma: no cover
-    raise ImportError(f"To use `{__name__}`, blacksheep must be installed.") from exc
-else:
+if _is_installed("blacksheep", __name__):
     from rodi import ContainerProtocol
 
 

injection/integrations/fastapi.py

@@ -0,0 +1,37 @@
+from collections.abc import Callable
+from typing import Any
+
+from injection import Module, mod
+from injection.exceptions import InjectionError
+from injection.integrations import _is_installed
+
+__all__ = ("Inject",)
+
+if _is_installed("fastapi", __name__):
+    from fastapi import Depends
+
+
+def Inject[T](cls: type[T] | Any, /, module: Module | None = None) -> Any:  # noqa: N802
+    """
+    Declare a FastAPI dependency with `python-injection`.
+    """
+
+    dependency: InjectionDependency[T] = InjectionDependency(cls, module or mod())
+    return Depends(dependency)
+
+
+class InjectionDependency[T]:
+    __slots__ = ("__call__",)
+
+    __call__: Callable[[], T]
+
+    def __init__(self, cls: type[T] | Any, module: Module):
+        lazy_instance = module.get_lazy_instance(cls)
+        self.__call__ = lambda: self.__ensure(~lazy_instance, cls)
+
+    @staticmethod
+    def __ensure[_T](instance: _T | None, cls: type[_T] | Any) -> _T:
+        if instance is None:
+            raise InjectionError(f"`{cls}` is an unknown dependency.")
+
+        return instance

injection/testing/__init__.py

@@ -1,4 +1,3 @@
-from contextlib import ContextDecorator
 from typing import ContextManager, Final
 
 from injection import mod
@@ -22,7 +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] | ContextDecorator:
+def load_test_profile(*other_profile_names: str) -> ContextManager[None]:
     return load_profile(_TEST_PROFILE_NAME, *other_profile_names)

injection/testing/__init__.pyi

@@ -1,4 +1,3 @@
-from contextlib import ContextDecorator
 from typing import ContextManager
 
 import injection as _
@@ -9,9 +8,7 @@ test_constant = _.constant
 test_injectable = _.injectable
 test_singleton = _.singleton
 
-def load_test_profile(
-    *additional_names: str,
-) -> ContextManager[None] | ContextDecorator:
+def load_test_profile(*other_profile_names: str) -> ContextManager[None]:
     """
     Context manager or decorator for temporary use test module.
     """

injection/utils.py

@@ -1,5 +1,5 @@
 from collections.abc import Callable, Iterator
-from contextlib import ContextDecorator, contextmanager
+from contextlib import contextmanager
 from importlib import import_module
 from pkgutil import walk_packages
 from types import ModuleType as PythonModule
@@ -10,11 +10,7 @@ from injection import mod
 __all__ = ("load_packages", "load_profile")
 
 
-def load_profile(
-    name: str,
-    /,
-    *other_profile_names: str,
-) -> ContextManager[None] | ContextDecorator:
+def load_profile(name: str, /, *other_profile_names: str) -> ContextManager[None]:
     """
     Injection module initialization function based on profile name.
     A profile name is equivalent to an injection module name.
@@ -27,12 +23,14 @@ def load_profile(
 
     target = mod().unlock().init_modules(*modules)
 
+    del module, modules
+
     @contextmanager
-    def teardown() -> Iterator[None]:
+    def cleaner() -> Iterator[None]:
         yield
         target.unlock().init_modules()
 
-    return teardown()
+    return cleaner()
 
 
 def load_packages(

{python_injection-0.10.4.dist-info → python_injection-0.10.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-injection
-Version: 0.10.4
+Version: 0.10.5
 Summary: Fast and easy dependency injection framework.
 Home-page: https://github.com/100nm/python-injection
 License: MIT
@@ -63,7 +63,6 @@ class Printer:
         self.history.append(message)
         print(message)
 
-
 @injectable
 class Service:
     def __init__(self, printer: Printer):
@@ -72,12 +71,10 @@ class Service:
     def hello(self):
         self.printer.print("Hello world!")
 
-
 @inject
 def main(service: Service):
     service.hello()
 
-
 if __name__ == "__main__":
     main()
 ```

{python_injection-0.10.4.dist-info → python_injection-0.10.5.dist-info}/RECORD

@@ -7,15 +7,16 @@ 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/hook.py,sha256=yk_X6rwcGqL3LYthX4yeYasDCfd0IhioOjFNjtH6bYU,2727
+injection/_core/hook.py,sha256=p9pC1zb9tDZykHs5HGM5VpRxWyvuajC45vilvkvatkY,2999
 injection/_core/module.py,sha256=1x5d3xlIwJxNiTHEIuHzZR4HOxXk6fMd45oZOiBYBUM,25376
 injection/exceptions.py,sha256=-5Shs7R5rctQXhpMLfcjiMBCzrtFWxC88qETUIHz57s,692
-injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/integrations/blacksheep.py,sha256=0cYXR_RRuUKGKaVpTjNmJwAqJfc7BQNbZldXuRgSp9U,1013
+injection/integrations/__init__.py,sha256=NYLcstr4ESdLj326LlDub143z6JGM1z1pCOVWhBXK10,304
+injection/integrations/blacksheep.py,sha256=yO5gLb_l4W3bNPFt-v2qWIL9R8PNon4JmOxQEHdi-5o,923
+injection/integrations/fastapi.py,sha256=5vocISPsQqJjD4g-QjXMKLa-rHqU1Rpysm2gb4VDI10,1056
 injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/testing/__init__.py,sha256=tVyoWBeJJ_GK6ms8AvK7knoKdt2moxNEeLFnXU9LWx0,813
-injection/testing/__init__.pyi,sha256=dhGVz0PqKQZz9UGS1lk7yRP1zVDlkN7EM8w4JKMUfLI,449
-injection/utils.py,sha256=4Go2EPkC7MBJIUD42x_RPT1yoJphqKDMftx4eN-6xos,2000
-python_injection-0.10.4.dist-info/METADATA,sha256=EZAPHGEk-5wiGb6hlliZbQM76KgmgEnMyCnmTWwsDDU,3062
-python_injection-0.10.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-python_injection-0.10.4.dist-info/RECORD,,
+injection/testing/__init__.py,sha256=-C38gmZJwDtLDAWJhqiaosOZWQZwwFa1M34tODcrASs,747
+injection/testing/__init__.pyi,sha256=6ZXbbS-9ppMdkxd03I6yBNurmR3Xw7sM_qiokibkLeY,386
+injection/utils.py,sha256=gPcxGIdrGz4irbJXGTYPw33jNy8jg56u_c61eb1MBSE,1971
+python_injection-0.10.5.dist-info/METADATA,sha256=Ka-CEnqFl0WybTXNsVRKEAp9UfEEsQungF6RVgATvBA,3059
+python_injection-0.10.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+python_injection-0.10.5.dist-info/RECORD,,