modern-di 0.10.0__py3-none-any.whl → 0.11.0__py3-none-any.whl

modern_di/providers/__init__.py

@@ -4,6 +4,7 @@ from modern_di.providers.context_adapter import ContextAdapter
 from modern_di.providers.dict import Dict
 from modern_di.providers.factory import Factory
 from modern_di.providers.list import List
+from modern_di.providers.object import Object
 from modern_di.providers.resource import Resource
 from modern_di.providers.selector import Selector
 from modern_di.providers.singleton import Singleton
@@ -16,6 +17,7 @@ __all__ = [
     "Dict",
     "Factory",
     "List",
+    "Object",
     "Resource",
     "Selector",
     "Singleton",

modern_di/providers/object.py

@@ -0,0 +1,27 @@
+import enum
+import typing
+
+from modern_di import Container
+from modern_di.providers.abstract import AbstractOverrideProvider
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+P = typing.ParamSpec("P")
+
+
+class Object(AbstractOverrideProvider[T_co]):
+    __slots__ = [*AbstractOverrideProvider.BASE_SLOTS, "_obj"]
+
+    def __init__(self, scope: enum.IntEnum, obj: T_co) -> None:
+        super().__init__(scope)
+        self._obj: typing.Final = obj
+
+    async def async_resolve(self, container: Container) -> T_co:
+        return self.sync_resolve(container)
+
+    def sync_resolve(self, container: Container) -> T_co:
+        container = container.find_container(self.scope)
+        if (override := container.fetch_override(self.provider_id)) is not None:
+            return typing.cast(T_co, override)
+
+        return self._obj

modern_di/providers/resource.py

@@ -1,4 +1,4 @@
-import contextlib
+import contextlib  # noqa: A005
 import enum
 import inspect
 import typing

{modern_di-0.10.0.dist-info → modern_di-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modern-di
-Version: 0.10.0
+Version: 0.11.0
 Summary: Dependency Injection framework with IOC-container and scopes
 Project-URL: repository, https://github.com/modern-python/modern-di
 Project-URL: docs, https://modern-di.readthedocs.io
@@ -40,7 +40,17 @@ It is in development state yet and gives you the following:
 
 📚 [Documentation](https://modern-di.readthedocs.io)
 
-## Describe resources and classes:
+# Quickstart
+
+## 1. Install `modern-di` using your favorite tool:
+
+```shell
+pip install modern-di
+uv add modern-di
+poetry add modern-di
+```
+
+## 2. Describe resources and classes:
 ```python
 import dataclasses
 import logging
@@ -74,7 +84,7 @@ class DependentFactory:
     async_resource: str
 ```
 
-## Describe dependencies graph (IoC-container)
+## 3. Describe dependencies graph
 ```python
 from modern_di import BaseGraph, Scope, providers
 
@@ -91,7 +101,15 @@ class Dependencies(BaseGraph):
     )
 ```
 
-## Create container and resolve dependencies in your code
+## 4.1. Integrate with your framework
+
+For now there are integration for the following frameworks:
+1. [FastAPI](https://modern-di.readthedocs.io/en/latest/integrations/fastapi.html)
+2. [LiteStar](https://modern-di.readthedocs.io/en/latest/integrations/litestar.html)
+
+## 4.2. Or use `modern-di` without integrations
+
+Create container and resolve dependencies in your code
 ```python
 from modern_di import Container, Scope
 

{modern_di-0.10.0.dist-info → modern_di-0.11.0.dist-info}/RECORD

@@ -4,7 +4,7 @@ modern_di/graph.py,sha256=X60wtG3Mqus_5YZNiZlQuXoHODBp7rYl_IHJs7GzSQM,1356
 modern_di/provider_state.py,sha256=oU08QnMr0yhIZKkz0Pee8_RnWtETDE9ux4JB83qhwTI,1358
 modern_di/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 modern_di/scope.py,sha256=e6Olc-CF89clbYDNGciy-F8EqJt1Mw2703zfuJaEY94,113
-modern_di/providers/__init__.py,sha256=tnF38UC-INW1GPPsGlj5tLqGi6fMfHodpi91wHDW-jY,649
+modern_di/providers/__init__.py,sha256=x4dzOpyyY6puc_ogtjch4xAdzz-8fN_dWefTjS1k2aI,709
 modern_di/providers/abstract.py,sha256=dgtAwzwtK-zyIHroxAT3QB5CV06sx3PUugYweZexkMc,3408
 modern_di/providers/container_provider.py,sha256=r5IEQXgKtPwvHvbqkbPnmGyDGGCCjokTtdard9Rvt40,548
 modern_di/providers/context_adapter.py,sha256=_b1x3ToQPWT-9KkDioFhw1W8Q1VXZYUnczfYzMTobVA,760
@@ -12,9 +12,10 @@ modern_di/providers/dict.py,sha256=nCU9iaqteYHDbILAfhrdnbMgS9_emE4MS7Xn2VoUlPo,8
 modern_di/providers/factory.py,sha256=Nn9WZuOHF4r5Go4vOuW_jAjmXs0A2WJCGiGQ1eUFB58,1507
 modern_di/providers/injected_factory.py,sha256=KkDww-zUgm41LFt5j8crRzzFuBSkmKvOfptzHWMgVok,1848
 modern_di/providers/list.py,sha256=3hx34RfBRmqzh-cT5D6wSTDJPkBGMK_ul4n9gQz-o9M,769
-modern_di/providers/resource.py,sha256=CsMekkVISklTqN539XqH4iE80vfc6sQMav5OT8fZvyA,4591
+modern_di/providers/object.py,sha256=Sm0mb3Ua7cZ5Ay65fLvl7fnJDSQrQZwvzio3lkkXP2A,825
+modern_di/providers/resource.py,sha256=Vp8psY_svOQEJ_38DWhR8ASYpqhP9DoB7bC0jH0IlaU,4605
 modern_di/providers/selector.py,sha256=RQbHD2-Liw-TGqu6UELbfCzXYuqxiO_Mg1tLyF3mKQo,1419
 modern_di/providers/singleton.py,sha256=_hUpCmbHgLAigdhBiu0zypwWwrIGdB6_oZkGfuLxzNE,2372
-modern_di-0.10.0.dist-info/METADATA,sha256=CwHhtofaNICrWExZ-9i_E9clyCsMxfWsU60qqpYzyJU,5505
-modern_di-0.10.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-modern_di-0.10.0.dist-info/RECORD,,
+modern_di-0.11.0.dist-info/METADATA,sha256=kal_732xHN0mXUyxkNdv4gDCK_MlQM12xOHiHcClcJs,5950
+modern_di-0.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+modern_di-0.11.0.dist-info/RECORD,,