python-injection 0.18.12__py3-none-any.whl → 0.18.14__py3-none-any.whl

injection/__init__.pyi

@@ -115,7 +115,7 @@ class Module:
         parameter type annotations. If applied to a class, the dependencies resolved
         will be those of the `__init__` method.
 
-        With `threadsafe=True`, the injection logic is wrapped in a `threading.Lock`.
+        With `threadsafe=True`, the injection logic is wrapped in a `threading.RLock`.
         """
 
     def injectable[**P, T](
@@ -171,18 +171,18 @@ class Module:
         registered.
         """
 
-    def constant[T](
+    def constant[**P, T](
         self,
-        wrapped: type[T] = ...,
+        wrapped: _Recipe[P, T] = ...,
         /,
         *,
         on: _TypeInfo[T] = ...,
         mode: Mode | ModeStr = ...,
     ) -> Any:
         """
-        Decorator applicable to a class. It is used to indicate how the constant is
-        constructed. At injection time, the injected instance will always be the same.
-        Unlike `@singleton`, dependencies will not be resolved.
+        Decorator applicable to a class or function. It is used to indicate how the
+        constant is constructed. At injection time, the injected instance will always
+        be the same. Unlike `@singleton`, dependencies will not be resolved.
         """
 
     def set_constant[T](

injection/_core/module.py

@@ -503,15 +503,15 @@ class Module(Broker, EventListener):
 
         return decorator(wrapped) if wrapped else decorator
 
-    def constant[T](
+    def constant[**P, T](
         self,
-        wrapped: type[T] | None = None,
+        wrapped: Recipe[P, T] | None = None,
         /,
         *,
         on: TypeInfo[T] = (),
         mode: Mode | ModeStr = Mode.get_default(),
     ) -> Any:
-        def decorator(wp: type[T]) -> type[T]:
+        def decorator(wp: Recipe[P, T]) -> Recipe[P, T]:
             lazy_instance = lazy(wp)
             self.injectable(
                 lambda: ~lazy_instance,
@@ -1087,7 +1087,7 @@ class InjectMetadata[**P, T](Caller[P, T], EventListener):
         return decorator(wrapped) if wrapped else decorator
 
     @singledispatchmethod
-    def on_event(self, event: Event, /) -> ContextManager[None] | None:  # type: ignore[override]
+    def on_event(self, event: Event, /) -> ContextManager[None] | None:
         return None
 
     @on_event.register

injection/loaders.py

@@ -149,14 +149,26 @@ class ProfileLoader:
     def __is_empty(self) -> bool:
         return not self.module_subsets
 
+    def required_module_names(self, name: str | None = None, /) -> frozenset[str]:
+        names = {self.module.name}
+
+        if name is not None:
+            names.add(name)
+
+        subsets = (self.__walk_subsets_for(name) for name in names)
+        return frozenset(itertools.chain.from_iterable(subsets))
+
     def init(self) -> Self:
         self.__init_subsets_for(self.module)
         return self
 
     def load(self, name: str, /) -> LoadedProfile:
         self.init()
-        target_module = self.__init_subsets_for(mod(name))
-        self.module.use(target_module, priority=Priority.HIGH)
+
+        if not self.__is_default_module(name):
+            target_module = self.__init_subsets_for(mod(name))
+            self.module.use(target_module, priority=Priority.HIGH)
+
         return _UserLoadedProfile(self, name)
 
     def _unload(self, name: str, /) -> None:
@@ -173,12 +185,21 @@ class ProfileLoader:
 
         return module
 
+    def __is_default_module(self, module_name: str) -> bool:
+        return module_name == self.module.name
+
     def __is_initialized(self, module: Module) -> bool:
         return module.name in self.__initialized_modules
 
     def __mark_initialized(self, module: Module) -> None:
         self.__initialized_modules.add(module.name)
 
+    def __walk_subsets_for(self, module_name: str) -> Iterator[str]:
+        yield module_name
+
+        for name in self.module_subsets.get(module_name, ()):
+            yield from self.__walk_subsets_for(name)
+
 
 @runtime_checkable
 class LoadedProfile(Protocol):

{python_injection-0.18.12.dist-info → python_injection-0.18.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.18.12
+Version: 0.18.14
 Summary: Fast and easy dependency injection framework.
 Project-URL: Repository, https://github.com/100nm/python-injection
 Author: remimd
@@ -14,6 +14,8 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -27,11 +29,10 @@ Description-Content-Type: text/markdown
 # python-injection
 
 [![CI](https://github.com/100nm/python-injection/actions/workflows/ci.yml/badge.svg)](https://github.com/100nm/python-injection)
-[![PyPI](https://img.shields.io/pypi/v/python-injection.svg?color=blue)](https://pypi.org/project/python-injection)
+[![PyPI - Version](https://img.shields.io/pypi/v/python-injection.svg?color=blue)](https://pypi.org/project/python-injection)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-injection.svg?color=blue)](https://pypistats.org/packages/python-injection)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
-Fast and easy dependency injection framework.
-
 ## Installation
 
 ⚠️ _Requires Python 3.12 or higher_
@@ -40,12 +41,22 @@ Fast and easy dependency injection framework.
 pip install python-injection
 ```
 
+## Features
+
+* Automatic dependency resolution based on type hints.
+* Support for multiple dependency lifetimes: `transient`, `singleton`, `constant`, and `scoped`.
+* Works seamlessly in both `async` and `sync` environments.
+* Separation of dependency sets using modules.
+* Runtime switching between different sets of dependencies.
+* Centralized setup logic using entrypoints.
+* Built-in type annotation for easy integration with [`FastAPI`](https://github.com/fastapi/fastapi).
+* Lazy dependency resolution for optimized performance.
+
 ## Motivations
 
 1. Easy to use
 2. No impact on class and function definitions
-3. Easily interchangeable dependencies _(depending on the runtime environment, for example)_
-4. No prerequisites
+3. No tedious configuration
 
 ## Quick start
 
@@ -90,5 +101,6 @@ if __name__ == "__main__":
 * [**Advanced usage**](https://github.com/100nm/python-injection/tree/prod/documentation/advanced-usage.md)
 * [**Loaders**](https://github.com/100nm/python-injection/tree/prod/documentation/loaders.md)
 * [**Entrypoint**](https://github.com/100nm/python-injection/tree/prod/documentation/entrypoint.md)
-* [**Integrations**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations.md)
+* [**Integrations**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations)
+  * [**FastAPI**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations/fastapi.md)
 * [**Concrete example**](https://github.com/100nm/python-injection-example)

{python_injection-0.18.12.dist-info → python_injection-0.18.14.dist-info}/RECORD

@@ -1,13 +1,13 @@
 injection/__init__.py,sha256=7ZRUlO5EEPWO7IlbYHD-8DOX-cg4Np4nYq5fpw-U56o,1259
-injection/__init__.pyi,sha256=65zhAK9LhuUXhftk7YDq2JJZ2zlPtNQ6UfrXaKcQgcA,10940
+injection/__init__.pyi,sha256=94F3A7lPmEyaJtsetVQpmS33LiY-BpymOLcFA6xvFBk,10964
 injection/entrypoint.py,sha256=12b0_zHAFxHCerAoJTIHkhqi3mLkgheECYAaCUZv_DU,4751
 injection/exceptions.py,sha256=v57yMujiq6H_zwwn30A8UYEZX9R9k-bY8FnsdaimPM4,1025
-injection/loaders.py,sha256=6TjVz9yaQDCVIPIIhjeC6GSXm9rn3oUU2b5KjfOYlsM,6568
+injection/loaders.py,sha256=gKlJfe9nXCuB8r6j0RF9_2FHC6YplM8GQYsgRqyxYw8,7257
 injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/descriptors.py,sha256=RRng9lx-ET6An1d_244rAv4iLUTQUGvDh1ugLfImuW8,794
 injection/_core/injectables.py,sha256=Rg1nxDkbcpeX4ELohrNVMguPhN36SNQuD0JKfyfL6bI,6192
-injection/_core/module.py,sha256=aSUHKLFJ63yx6FgJ6AKpDccaZ-H1YpKQyoaKxb4YXfk,32414
+injection/_core/module.py,sha256=lQFhfc9vDCiENkMvgkCzc-wW50uEl2bjKKBfRlR6nv8,32408
 injection/_core/scope.py,sha256=NY6YWcIIXqBKTjXVsqsahxbw-bPJiL0CwHp6CyjBGJo,8753
 injection/_core/slots.py,sha256=g9TG6CbqRzCsjg01iPyfRtTTUCJnnJOwcj9mJabH0dc,37
 injection/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -23,7 +23,7 @@ injection/ext/fastapi.py,sha256=YdCVO1WgZRhv0CFrDnIdsbeRprtcHb-snIL4B4mpLnk,1388
 injection/ext/fastapi.pyi,sha256=HLs7mfruIEFRrN_Xf8oCvSa4qwHWfwm6HHU_KMedXkE,185
 injection/testing/__init__.py,sha256=bJ7WXBXrw4rHc91AFVFnOwFLWOlpvX9Oh2SnRQ_NESo,919
 injection/testing/__init__.pyi,sha256=raGsGlxwbz3jkzJwA_5oCIE1emWINjT2UuwzbnqRb-0,577
-python_injection-0.18.12.dist-info/METADATA,sha256=lwLVbS0w8BBY2FcYsZMO6McGJnMZRxOee8Q-jx0x47o,3398
-python_injection-0.18.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_injection-0.18.12.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
-python_injection-0.18.12.dist-info/RECORD,,
+python_injection-0.18.14.dist-info/METADATA,sha256=jtUZE1HuKfARdckxvXvKbw-xSnBuLEq0KTi5gmZZx2c,4155
+python_injection-0.18.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_injection-0.18.14.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
+python_injection-0.18.14.dist-info/RECORD,,