python-injection 0.14.0__tar.gz → 0.14.1__tar.gz

{python_injection-0.14.0 → python_injection-0.14.1}/PKG-INFO

@@ -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 → python_injection-0.14.1}/README.md

@@ -55,6 +55,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 → python_injection-0.14.1}/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

{python_injection-0.14.0 → python_injection-0.14.1}/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

{python_injection-0.14.0 → python_injection-0.14.1}/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()

{python_injection-0.14.0 → python_injection-0.14.1}/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
 
 

{python_injection-0.14.0 → python_injection-0.14.1}/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)

{python_injection-0.14.0 → python_injection-0.14.1}/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.
     """

{python_injection-0.14.0 → python_injection-0.14.1}/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 → python_injection-0.14.1}/pyproject.toml

@@ -24,7 +24,7 @@ test = [
 
 [project]
 name = "python-injection"
-version = "0.14.0"
+version = "0.14.1"
 description = "Fast and easy dependency injection framework."
 license = { text = "MIT" }
 readme = "README.md"