python-injection 0.19.5.post1__py3-none-any.whl → 0.19.7__py3-none-any.whl

injection/__init__.pyi

@@ -374,7 +374,7 @@ class Module:
         *,
         alias: bool = ...,
         mode: Mode | ModeStr = ...,
-    ) -> Self:
+    ) -> T:
         """
         Function for registering a specific instance to be injected. This is useful for
         registering global variables. The difference with the singleton decorator is

injection/_core/common/threading.py

@@ -1,7 +1,11 @@
 from contextlib import nullcontext
+from os import getenv
 from threading import RLock
-from typing import Any, ContextManager
+from typing import Any, ContextManager, Final
+
+_PYTHON_INJECTION_THREADSAFE: Final[bool] = bool(getenv("PYTHON_INJECTION_THREADSAFE"))
 
 
 def get_lock(threadsafe: bool | None = None) -> ContextManager[Any]:
-    return RLock() if threadsafe else nullcontext()
+    cond = _PYTHON_INJECTION_THREADSAFE if threadsafe is None else threadsafe
+    return RLock() if cond else nullcontext()

injection/_core/module.py

@@ -532,16 +532,21 @@ class Module(Broker, EventListener):
         *,
         alias: bool = False,
         mode: Mode | ModeStr = Mode.get_default(),
-    ) -> Self:
-        hints = on if alias else (type(instance), on)
+    ) -> T:
+        if not alias:
+            on = (type(instance), on)
+
+        elif not on:
+            raise ValueError("`on` must be provided when `alias` is `True`.")
+
         self.injectable(
             lambda: instance,
             ignore_type_hint=True,
             inject=False,
-            on=hints,
+            on=on,
             mode=mode,
         )
-        return self
+        return instance
 
     def reserve_scoped_slot[T](
         self,

{python_injection-0.19.5.post1.dist-info → python_injection-0.19.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.19.5.post1
+Version: 0.19.7
 Summary: Fast and easy dependency injection framework.
 Project-URL: Repository, https://github.com/100nm/python-injection
 Author: remimd
@@ -92,8 +92,14 @@ 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.
+> ⚠️ The package isn't threadsafe by default, for better performance in single-threaded applications and those using
+> `asyncio`.
+> 
+> Non-threadsafe functions are those that resolve dependencies or define scopes. They all come with an optional 
+> parameter `threadsafe`.
+> 
+> You can set `PYTHON_INJECTION_THREADSAFE=1` in environment variables to make the package fully threadsafe. The 
+> environment variable is resolved at the **Python module level**, so be careful if the variable is defined dynamically.
 
 * [**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)

{python_injection-0.19.5.post1.dist-info → python_injection-0.19.7.dist-info}/RECORD

@@ -1,5 +1,5 @@
 injection/__init__.py,sha256=iJm0BbyGZw-Qr5e8d2C3n8-7FiVD-sy4LU_i_n3AgHY,1318
-injection/__init__.pyi,sha256=8uWRfGfkVCfWBx4X4XsRyo1l7vKym6-vmcMklPyVMqg,15672
+injection/__init__.pyi,sha256=l4TChZY33TGkkNXRl0hL82XNkPZHH5TvWed146_82TQ,15669
 injection/entrypoint.py,sha256=W76YNPNgvT5UGb2lAqMas4GKPl7xb8GW3rRL34jIWzU,5017
 injection/exceptions.py,sha256=v57yMujiq6H_zwwn30A8UYEZX9R9k-bY8FnsdaimPM4,1025
 injection/loaders.py,sha256=gKlJfe9nXCuB8r6j0RF9_2FHC6YplM8GQYsgRqyxYw8,7257
@@ -8,7 +8,7 @@ injection/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/asfunction.py,sha256=fTgAAWsDWUz89kYsoSVDXdqYKIuh6HtUW5MohGp3ov4,1767
 injection/_core/descriptors.py,sha256=1OX6JnM8Ux14vW1JSW3FzPgKc2VMTKqJUYBGT3Ypafg,800
 injection/_core/injectables.py,sha256=fxhiGv7qTCbUunhhd6a3ahosFmgznUFsEvqlwxi4gS4,6098
-injection/_core/module.py,sha256=ibWfaNNVjQ4ccu7rabvXeog_EDCsjS-TbFBMuRHXS_k,32616
+injection/_core/module.py,sha256=kUOzW7CYf3oGgVBhwJT1-05UI-HLH2N_E4o17Fyw1g4,32721
 injection/_core/scope.py,sha256=r094k1Vjvwm0hTf7AQGYrxxvqQgb7_CDVUKaHQ8wyeM,8772
 injection/_core/slots.py,sha256=g9TG6CbqRzCsjg01iPyfRtTTUCJnnJOwcj9mJabH0dc,37
 injection/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -17,14 +17,14 @@ injection/_core/common/event.py,sha256=XjzV8gxtGlGvzZs_ykvoC60qmdpd3RN08Eiqz5QUw
 injection/_core/common/invertible.py,sha256=gA_vw5nBjgp_w9MrDK5jMO8lhuOQWON8BbPpKzEuIY0,502
 injection/_core/common/key.py,sha256=ghkZD-Y8Moz6SEPNgMh3xgsZUjDVq-XYAmXaCu5VuCA,80
 injection/_core/common/lazy.py,sha256=hZvz9LhlYxVkD_D8VBAvQmy7YuVaaw075jq0XM0w9_Y,1193
-injection/_core/common/threading.py,sha256=kwRXNa9ocndIqeZA9kMHjEa8SBpHFcJARj1bgrWCpxE,225
+injection/_core/common/threading.py,sha256=LR5_wiwZ9_YrcOOKg0qtwbe1YqYdYP57-PAFIe4bknM,415
 injection/_core/common/type.py,sha256=U7PtuH-FuMgw75LB7xy-arJRJXojxsJDQbhnTqA4P-o,2567
 injection/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/ext/fastapi.py,sha256=fiy3-mZIIwGcql3Y5ekFX8_7hALzqXP5u40qbtNE73o,1441
 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.19.5.post1.dist-info/METADATA,sha256=fQmu5jF3kcYKuP4_asLoWog9iD4w1snv_udc43D_CTc,4307
-python_injection-0.19.5.post1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_injection-0.19.5.post1.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
-python_injection-0.19.5.post1.dist-info/RECORD,,
+python_injection-0.19.7.dist-info/METADATA,sha256=1ez9nTKcHGa1jqWVzYM2I_NaFi9W0wuwkmHmJuHvhg0,4613
+python_injection-0.19.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_injection-0.19.7.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
+python_injection-0.19.7.dist-info/RECORD,,