PyPI - python-injection - Versions diffs - 0.14.0__tar.gz → 0.14.0.post0__tar.gz - Mend

python-injection 0.14.0tar.gz → 0.14.0.post0tar.gz

Files changed (26) hide show

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.14.0
+Version: 0.14.0.post0
 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)

@@ -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)

@@ -281,7 +281,7 @@ class Module:
         module: Module,
         *,
         priority: Priority | PriorityStr = ...,
-    ) -> Iterator[None]:
+    ) -> Iterator[Self]:
         """
         Context manager or decorator for temporary use of a module.
         """
@@ -305,7 +305,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

@@ -1,4 +1,5 @@
 import itertools
+from collections import deque
 from collections.abc import Callable, Generator, Iterator
 from dataclasses import dataclass, field
 from inspect import isclass, isgeneratorfunction
@@ -13,8 +14,8 @@ type HookFunction[**P, T] = Callable[P, T] | HookGeneratorFunction[P, T]
 @dataclass(eq=False, frozen=True, slots=True)
 class Hook[**P, T]:
-    __functions: list[HookFunction[P, T]] = field(
-        default_factory=list,
+    __functions: deque[HookFunction[P, T]] = field(
+        default_factory=deque,
         init=False,
         repr=False,
     )
@@ -35,7 +36,7 @@ class Hook[**P, T]:
         return iter(self.__functions)
     def add(self, *functions: HookFunction[P, T]) -> Self:
-        self.__functions.extend(reversed(functions))
+        self.__functions.extendleft(functions)
         return self
     @classmethod

@@ -739,11 +739,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 +762,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 +773,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()

@@ -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

@@ -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)

@@ -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.
     """

@@ -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.

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