python-injection 0.14.0__py3-none-any.whl → 0.14.1__py3-none-any.whl

injection/__init__.pyi

@@ -10,6 +10,7 @@ from ._core.common.type import InputType as _InputType
 from ._core.common.type import TypeInfo as _TypeInfo
 from ._core.module import InjectableFactory as _InjectableFactory
 from ._core.module import ModeStr, PriorityStr
+from ._core.module import Recipe as _Recipe
 
 __MODULE: Final[Module] = ...
 
@@ -91,7 +92,7 @@ class Module:
 
     def injectable[**P, T](
         self,
-        wrapped: Callable[P, T] | Callable[P, Awaitable[T]] = ...,
+        wrapped: _Recipe[P, T] = ...,
         /,
         *,
         cls: _InjectableFactory[T] = ...,
@@ -107,7 +108,7 @@ class Module:
 
     def singleton[**P, T](
         self,
-        wrapped: Callable[P, T] | Callable[P, Awaitable[T]] = ...,
+        wrapped: _Recipe[P, T] = ...,
         /,
         *,
         inject: bool = ...,
@@ -176,6 +177,12 @@ class Module:
         /,
         threadsafe: bool = ...,
     ) -> Callable[P, T]: ...
+    def make_async_factory[T](
+        self,
+        wrapped: type[T],
+        /,
+        threadsafe: bool = ...,
+    ) -> Callable[..., Awaitable[T]]: ...
     async def afind_instance[T](self, cls: _InputType[T]) -> T: ...
     def find_instance[T](self, cls: _InputType[T]) -> T:
         """
@@ -281,7 +288,7 @@ class Module:
         module: Module,
         *,
         priority: Priority | PriorityStr = ...,
-    ) -> Iterator[None]:
+    ) -> Iterator[Self]:
         """
         Context manager or decorator for temporary use of a module.
         """
@@ -305,7 +312,7 @@ class Module:
         """
 
     @contextmanager
-    def load_profile(self, *names: str) -> Iterator[None]: ...
+    def load_profile(self, *names: str) -> Iterator[Self]: ...
     async def all_ready(self) -> None: ...
     def add_logger(self, logger: Logger) -> Self: ...
     @classmethod

injection/_core/hook.py

@@ -64,7 +64,6 @@ class Hook[**P, T]:
                     hook.throw(exc)
                 else:
                     hook.send(value)
-                    return value
 
             except StopIteration as stop:
                 return stop.value

injection/_core/module.py

@@ -3,10 +3,12 @@ from __future__ import annotations
 from abc import ABC, abstractmethod
 from collections import OrderedDict, deque
 from collections.abc import (
+    AsyncGenerator,
     AsyncIterator,
     Awaitable,
     Callable,
     Collection,
+    Generator,
     Iterable,
     Iterator,
     Mapping,
@@ -360,6 +362,14 @@ class Priority(StrEnum):
 
 type PriorityStr = Literal["low", "high"]
 
+type ContextManagerLikeRecipe[**P, T] = (
+    Callable[P, ContextManager[T]] | Callable[P, AsyncContextManager[T]]
+)
+type GeneratorRecipe[**P, T] = (
+    Callable[P, Generator[T, Any, Any]] | Callable[P, AsyncGenerator[T, Any]]
+)
+type Recipe[**P, T] = Callable[P, T] | Callable[P, Awaitable[T]]
+
 
 @dataclass(eq=False, frozen=True, slots=True)
 class Module(Broker, EventListener):
@@ -411,7 +421,7 @@ class Module(Broker, EventListener):
 
     def injectable[**P, T](
         self,
-        wrapped: Callable[P, T] | Callable[P, Awaitable[T]] | None = None,
+        wrapped: Recipe[P, T] | None = None,
         /,
         *,
         cls: InjectableFactory[T] = SimpleInjectable,
@@ -420,9 +430,7 @@ class Module(Broker, EventListener):
         on: TypeInfo[T] = (),
         mode: Mode | ModeStr = Mode.get_default(),
     ) -> Any:
-        def decorator(
-            wp: Callable[P, T] | Callable[P, Awaitable[T]],
-        ) -> Callable[P, T] | Callable[P, Awaitable[T]]:
+        def decorator(wp: Recipe[P, T]) -> Recipe[P, T]:
             factory = extract_caller(self.make_injected_function(wp) if inject else wp)
             hints = on if ignore_type_hint else (wp, on)
             updater = Updater(
@@ -447,23 +455,10 @@ class Module(Broker, EventListener):
         mode: Mode | ModeStr = Mode.get_default(),
     ) -> Any:
         def decorator(
-            wrapped: Callable[P, T]
-            | Callable[P, Awaitable[T]]
-            | Callable[P, Iterator[T]]
-            | Callable[P, AsyncIterator[T]],
-        ) -> (
-            Callable[P, T]
-            | Callable[P, Awaitable[T]]
-            | Callable[P, Iterator[T]]
-            | Callable[P, AsyncIterator[T]]
-        ):
+            wrapped: Recipe[P, T] | GeneratorRecipe[P, T],
+        ) -> Recipe[P, T] | GeneratorRecipe[P, T]:
             injectable_class: Callable[[Caller[P, Any], str], Injectable[T]]
-            wrapper: (
-                Callable[P, T]
-                | Callable[P, Awaitable[T]]
-                | Callable[P, ContextManager[T]]
-                | Callable[P, AsyncContextManager[T]]
-            )
+            wrapper: Recipe[P, T] | ContextManagerLikeRecipe[P, T]
 
             if isasyncgenfunction(wrapped):
                 hint = get_yield_hint(wrapped)
@@ -588,6 +583,18 @@ class Module(Broker, EventListener):
 
         return SyncInjectedFunction(metadata)
 
+    def make_async_factory[T](
+        self,
+        wrapped: type[T],
+        /,
+        threadsafe: bool = False,
+    ) -> Callable[..., Awaitable[T]]:
+        factory: InjectedFunction[..., T] = self.make_injected_function(
+            wrapped,
+            threadsafe,
+        )
+        return factory.__inject_metadata__.acall
+
     async def afind_instance[T](self, cls: InputType[T]) -> T:
         injectable = self[cls]
         return await injectable.aget_instance()
@@ -739,11 +746,11 @@ class Module(Broker, EventListener):
         module: Module,
         *,
         priority: Priority | PriorityStr = Priority.get_default(),
-    ) -> Iterator[None]:
+    ) -> Iterator[Self]:
         self.use(module, priority=priority)
 
         try:
-            yield
+            yield self
         finally:
             self.stop_using(module)
 
@@ -762,7 +769,7 @@ class Module(Broker, EventListener):
 
         return self
 
-    def load_profile(self, *names: str) -> ContextManager[None]:
+    def load_profile(self, *names: str) -> ContextManager[Self]:
         modules = tuple(self.from_name(name) for name in names)
 
         for module in modules:
@@ -773,8 +780,8 @@ class Module(Broker, EventListener):
         del module, modules
 
         @contextmanager
-        def cleaner() -> Iterator[None]:
-            yield
+        def cleaner() -> Iterator[Self]:
+            yield self
             self.unlock().init_modules()
 
         return cleaner()

injection/_core/scope.py

@@ -121,11 +121,8 @@ def _bind_scope(name: str, scope: Scope, shared: bool) -> Iterator[None]:
             f"Scope `{name}` is already defined in the current context."
         )
 
-    strategy = (
-        state.bind_shared_scope(scope) if shared else state.bind_contextual_scope(scope)
-    )
-
-    with strategy:
+    strategy = state.bind_shared_scope if shared else state.bind_contextual_scope
+    with strategy(scope):
         yield
 
 

injection/testing/__init__.py

@@ -1,6 +1,6 @@
 from typing import ContextManager, Final
 
-from injection import mod
+from injection import Module, mod
 from injection.utils import load_profile
 
 __all__ = (
@@ -23,5 +23,5 @@ test_scoped = mod(_TEST_PROFILE_NAME).scoped
 test_singleton = mod(_TEST_PROFILE_NAME).singleton
 
 
-def load_test_profile(*names: str) -> ContextManager[None]:
+def load_test_profile(*names: str) -> ContextManager[Module]:
     return load_profile(_TEST_PROFILE_NAME, *names)

injection/testing/__init__.pyi

@@ -11,7 +11,7 @@ test_injectable = __MODULE.injectable
 test_scoped = __MODULE.scoped
 test_singleton = __MODULE.singleton
 
-def load_test_profile(*names: str) -> ContextManager[None]:
+def load_test_profile(*names: str) -> ContextManager[Module]:
     """
     Context manager or decorator for temporary use test module.
     """

injection/utils.py

@@ -5,13 +5,13 @@ from pkgutil import walk_packages
 from types import ModuleType as PythonModule
 from typing import ContextManager
 
+from injection import Module, mod
 from injection import __name__ as injection_package_name
-from injection import mod
 
 __all__ = ("load_modules_with_keywords", "load_packages", "load_profile")
 
 
-def load_profile(*names: str) -> ContextManager[None]:
+def load_profile(*names: str) -> ContextManager[Module]:
     """
     Injection module initialization function based on profile name.
     A profile name is equivalent to an injection module name.

{python_injection-0.14.0.dist-info → python_injection-0.14.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.14.0
+Version: 0.14.1
 Summary: Fast and easy dependency injection framework.
 Project-URL: Repository, https://github.com/100nm/python-injection
 Author: remimd
@@ -78,6 +78,9 @@ if __name__ == "__main__":
 
 ## Resources
 
+> ⚠️ The package isn't threadsafe, for better performance in single-threaded applications and those using `asyncio`.
+> So remember to use `threading.Lock` if you're writing a multithreaded program.
+
 * [**Basic usage**](https://github.com/100nm/python-injection/tree/prod/documentation/basic-usage.md)
 * [**Scoped dependencies**](https://github.com/100nm/python-injection/tree/prod/documentation/scoped-dependencies.md)
 * [**Testing**](https://github.com/100nm/python-injection/tree/prod/documentation/testing.md)

{python_injection-0.14.0.dist-info → python_injection-0.14.1.dist-info}/RECORD

@@ -1,14 +1,14 @@
 injection/__init__.py,sha256=X0vIAoN4MDlhR7YIkup1qHgqbOkwZ3PWgdSi7h-udaM,1049
-injection/__init__.pyi,sha256=f3EhwOaJCnf37YZQdANvbUsAq360zn-62zFLNLJxvoQ,9916
+injection/__init__.pyi,sha256=6B5GdRNaAJ15Q-QAL8nNpTBVIKEUPJAwWIlCSjOkkJ8,10058
 injection/exceptions.py,sha256=T__732aXxWWUz0sKc39ySteyolCS5tpqQC0oCnzUF2E,917
 injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/utils.py,sha256=s4wwe98owmgVIkxzAg-mu9yvFISWOzz1AvF7eF7-2xY,2752
+injection/utils.py,sha256=Lr0qHaq3_1AkUoAaw2XmMNie_alwYTeTrRlO22FeCnk,2762
 injection/_core/__init__.py,sha256=XERocCxCZBxPGIaOR37yeiQOZyvjHQ6a4rgRmlkUSuU,1367
 injection/_core/descriptors.py,sha256=7fSHlgAqmgR_Uta8KocBapOt1Xyj2dI7RY9ZdoStTzw,726
-injection/_core/hook.py,sha256=Qv505pr3kjOE6UitftlLh9JKX9OCNqZBRtHbFha1gqM,3130
+injection/_core/hook.py,sha256=rJyaSwFAHM8qizWANPUSt5KzWdjxc5oJ2U8hcGeZjU8,3097
 injection/_core/injectables.py,sha256=GIumNp0TXf8Voxe1sCPhcqq2gyw4E_hl7I45IJ_tyHE,4512
-injection/_core/module.py,sha256=kotXKuOFv8Gt31J1R8nSgVnu-83_MhIV4B5Etu8_kzo,30968
-injection/_core/scope.py,sha256=uZps_kQsXDL9tXRzF1ECK8ua3cdEXiIAxrrhPt8JNqg,5461
+injection/_core/module.py,sha256=Dxpdtsft-BaaPRj2v1YFepF1y1s7QINoa9iDxQLGJjM,31154
+injection/_core/scope.py,sha256=pwOqVKOUM_ZteNScgp-hLqyOHg5Ew75jWlfWLLD2PU8,5437
 injection/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/common/asynchronous.py,sha256=9bQDVRE6eqo9K0d5H9RzyFalf0WGoGP7cDrKDGbvZPI,1500
 injection/_core/common/event.py,sha256=XjzV8gxtGlGvzZs_ykvoC60qmdpd3RN08Eiqz5QUwes,1236
@@ -18,8 +18,8 @@ injection/_core/common/lazy.py,sha256=6xh5h0lmaNvl32V0WoX4VCTsNJ3zUJdWVqpLJ_YeII
 injection/_core/common/type.py,sha256=QbBBhJp7i1p6gLzWX0TgofvfG7yDH-gHfEQcssVZeHo,2186
 injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/integrations/fastapi.py,sha256=YHSs85_3m6TUVtOwUcV157b3UZJQIw_aXWAg199a-YE,594
-injection/testing/__init__.py,sha256=ALcKuDYNdslmpgqotZzSWrXAW0kNNFUs9nzfO1ZgIGc,783
-injection/testing/__init__.pyi,sha256=6rv5NOYHEaiKMd82E1IIc8lFlLV9ttY57DLiMqGTXt8,482
-python_injection-0.14.0.dist-info/METADATA,sha256=A25sC1rCj-HHSw-Sf57IIyHLhiPuDXUt53BdLBpKPnY,2996
-python_injection-0.14.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_injection-0.14.0.dist-info/RECORD,,
+injection/testing/__init__.py,sha256=Bh3JqEXw62-JnUnspOXr2jpjGXZJ_K_K9CgfD7dPZeQ,793
+injection/testing/__init__.pyi,sha256=1h9zNGghxlo4D1jAx5s8EHk54mn7o-qO7WgJa6hwX6U,484
+python_injection-0.14.1.dist-info/METADATA,sha256=CMClwSxU8s_yCBYsduNEXc1426OeyWQzGFHTlQxe1eo,3199
+python_injection-0.14.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_injection-0.14.1.dist-info/RECORD,,