python-injection 0.19.6__tar.gz → 0.19.7__tar.gz

{python_injection-0.19.6 → python_injection-0.19.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.19.6
+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.6 → python_injection-0.19.7}/README.md

@@ -64,8 +64,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.7/injection/_core/common/threading.py

@@ -0,0 +1,11 @@
+from contextlib import nullcontext
+from os import getenv
+from threading import RLock
+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]:
+    cond = _PYTHON_INJECTION_THREADSAFE if threadsafe is None else threadsafe
+    return RLock() if cond else nullcontext()

{python_injection-0.19.6 → python_injection-0.19.7}/pyproject.toml

@@ -30,7 +30,7 @@ test = [
 
 [project]
 name = "python-injection"
-version = "0.19.6"
+version = "0.19.7"
 description = "Fast and easy dependency injection framework."
 license = "MIT"
 license-files = ["LICENSE"]

python_injection-0.19.6/injection/_core/common/threading.py

@@ -1,7 +0,0 @@
-from contextlib import nullcontext
-from threading import RLock
-from typing import Any, ContextManager
-
-
-def get_lock(threadsafe: bool | None = None) -> ContextManager[Any]:
-    return RLock() if threadsafe else nullcontext()