Add injection contexts that share scope, cache, overrides and lifecycle between multiple injections

.gitignore

@@ -5,3 +5,4 @@ __pycache__
 .python-version
 docs/_build
 play.py
+play*.py

CITATION.cff

@@ -18,6 +18,6 @@ keywords:
   - dependency injection
   - fundi
 license: LGPL-3.0
-commit: bca6f9b886da89d52493d3ccf3142418d063ce7e
-version: 1.5.0
-date-released: '2025-10-10'
+commit: c9638062cbb2d4c3facfa0cbaae90bde27fc1767
+version: 1.6.1
+date-released: '2026-03-12'

docs/advanced.rst

@@ -153,6 +153,7 @@ but itself is not a coroutine function. In this case you will need
 to override ``async_`` property of the dependency:
 
 .. code-block:: python 
+
     from fundi import from_
 
     def require_event_data(event: RemoteEvent):
@@ -177,6 +178,7 @@ For example, if there is function that returns context-manager and type-hint is
 to contextlib.AbstractContextManager FunDI will correctly infer it as lifespan dependency.
 
 .. code-block:: python
+
     from fundi import from_
 
     from contextlib import AbstractContextManager

docs/conf.py

@@ -14,7 +14,7 @@
 project = "FunDI"
 copyright = "2025, Kuyugama"
 author = "Kuyugama"
-release = "1.5.0"
+release = "1.6.1"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

docs/howtos/debugging.rst

@@ -11,9 +11,9 @@ FunDI provides useful functions to help you debug and optimize your dependency i
 
       .. code-block:: python
 
-        from fundi import tree, scan
+        from fundi import Scope, tree, scan
 
-        print(tree({"username": "user"}, scan(application)))
+        print(tree(Scope({"username": "user"}), scan(application)))
 
       Outputs::
 
@@ -27,9 +27,9 @@ FunDI provides useful functions to help you debug and optimize your dependency i
 
       .. code-block:: python
 
-        from fundi import order, scan
+        from fundi import Scope, order, scan
 
-        print(order({"username": "user"}, scan(application)))
+        print(order(Scope({"username": "user"}), scan(application)))
 
       Outputs::
 
@@ -57,7 +57,7 @@ library adds its injection trace to exception.
 
     from contextlib import ExitStack
 
-    from fundi import from_, scan, inject, injection_trace
+    from fundi import Scope, from_, scan, inject, injection_trace
 
 
     def require_random_animal() -> str:
@@ -72,7 +72,7 @@ library adds its injection trace to exception.
 
 
     try:
-        inject({}, scan(application))
+        inject(Scope(), scan(application))
     except Exception as e:
         print(injection_trace(e))
 

docs/howtos/injection.rst

@@ -25,7 +25,7 @@ Example of synchronous injection:
     import secrets
     from contextlib import ExitStack
 
-    from fundi import from_, scan, inject
+    from fundi import Scope, from_, scan, inject
 
 
     def require_unique_id() -> str:
@@ -36,7 +36,7 @@ Example of synchronous injection:
         print(f"Application started with {user_id = } and {username = }")
 
 
-    inject({"username": "Kuyugama"}, scan(application))
+    inject(Scope({"username": "Kuyugama"}), scan(application))
 
 
 Example of asynchronous injection:
@@ -47,7 +47,7 @@ Example of asynchronous injection:
     import asyncio
     from contextlib import AsyncExitStack
 
-    from fundi import from_, scan, ainject
+    from fundi import Scope, from_, scan, ainject
 
 
     async def require_user(username: str) -> str:
@@ -60,7 +60,7 @@ Example of asynchronous injection:
 
 
     async def main():
-        ainject({"username": "Kuyugama"}, scan(application))
+        await ainject(Scope({"username": "Kuyugama"}), scan(application))
 
     if __name__ == "__main__":
         asyncio.run(main())
@@ -72,14 +72,14 @@ Example of injection that produces value:
     import secrets
     from contextlib import ExitStack
 
-    from fundi import scan, inject
+    from fundi import Scope, scan, inject
 
 
     def require_unique_id() -> str:
         return secrets.token_hex(12)
 
 
-    user_id = inject({}, scan(require_user_id))
+    user_id = inject(Scope(), scan(require_unique_id))
     print("Generated user id is", user_id)
 
 ..

docs/howtos/overriding.rst

@@ -23,7 +23,7 @@ Example of overriding dependency result:
 
 .. code-block:: python
 
-    from fundi import scan, inject
+    from fundi import Scope, scan, inject
 
     from src import application
     from src.models import User
@@ -35,7 +35,7 @@ Example of overriding dependency result:
         username="test_user",
     )
 
-    inject({"username": test_user.username}, scan(application), override={require_user: test_user})
+    inject(Scope({"username": test_user.username}), scan(application), override={require_user: test_user})
 
 
 Example of overriding dependency callable:
@@ -44,7 +44,7 @@ Example of overriding dependency callable:
 
     from contextlib import ExitStack
 
-    from fundi import scan, inject
+    from fundi import Scope, scan, inject
 
     from src import application
     from src.models import User
@@ -61,5 +61,9 @@ Example of overriding dependency callable:
         return test_user
 
 
-    inject({"username": test_user.username}, scan(application), override={require_user: scan(test_require_user)})
+    inject(
+        Scope({"username": test_user.username}), 
+        scan(application), 
+        override={require_user: scan(test_require_user)}
+    )