modern-di 0.10.0__tar.gz → 0.11.0__tar.gz

{modern_di-0.10.0 → modern_di-0.11.0}/PKG-INFO

@@ -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 → modern_di-0.11.0}/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-0.11.0/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-0.10.0 → modern_di-0.11.0}/modern_di/providers/resource.py

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