modern-di-fastapi 1.0.0a0__tar.gz

modern_di_fastapi-1.0.0a0/.gitignore

@@ -0,0 +1,22 @@
+# Generic things
+*.pyc
+*~
+__pycache__/*
+*.swp
+*.sqlite3
+*.map
+.vscode
+.idea
+.DS_Store
+.env
+.mypy_cache
+.pytest_cache
+.ruff_cache
+.coverage
+htmlcov/
+coverage.xml
+pytest.xml
+dist/
+.python-version
+.venv
+uv.lock

modern_di_fastapi-1.0.0a0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: modern-di-fastapi
+Version: 1.0.0a0
+Summary: Modern-DI integration for FastAPI
+Project-URL: repository, https://github.com/modern-python/modern-di
+Project-URL: docs, https://modern-di.readthedocs.io
+Author-email: Artur Shiriev <me@shiriev.ru>
+License-Expression: MIT
+Keywords: DI,FastAPI,dependency injector,ioc-container,python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.10
+Requires-Dist: fastapi>=0.100
+Requires-Dist: modern-di>=1
+Description-Content-Type: text/markdown
+
+"Modern-DI-FastAPI"
+==
+
+Integration of [Modern-DI](https://github.com/modern-python/modern-di) to FastAPI
+
+📚 [Documentation](https://modern-di.readthedocs.io)

modern_di_fastapi-1.0.0a0/README.md

@@ -0,0 +1,6 @@
+"Modern-DI-FastAPI"
+==
+
+Integration of [Modern-DI](https://github.com/modern-python/modern-di) to FastAPI
+
+📚 [Documentation](https://modern-di.readthedocs.io)

modern_di_fastapi-1.0.0a0/modern_di_fastapi/__init__.py

@@ -0,0 +1,9 @@
+from modern_di_fastapi.main import FromDI, build_di_container, fetch_di_container, setup_di
+
+
+__all__ = [
+    "FromDI",
+    "build_di_container",
+    "fetch_di_container",
+    "setup_di",
+]

modern_di_fastapi-1.0.0a0/modern_di_fastapi/main.py

@@ -0,0 +1,61 @@
+import contextlib
+import dataclasses
+import typing
+
+import fastapi
+from fastapi.routing import _merge_lifespan_context
+from modern_di import AsyncContainer, Scope, providers
+from starlette.requests import HTTPConnection
+
+
+T_co = typing.TypeVar("T_co", covariant=True)
+
+
+def fetch_di_container(app_: fastapi.FastAPI) -> AsyncContainer:
+    return typing.cast(AsyncContainer, app_.state.di_container)
+
+
+@contextlib.asynccontextmanager
+async def _lifespan_manager(app_: fastapi.FastAPI) -> typing.AsyncIterator[None]:
+    async with fetch_di_container(app_):
+        yield
+
+
+def setup_di(app: fastapi.FastAPI, container: AsyncContainer) -> AsyncContainer:
+    app.state.di_container = container
+    old_lifespan_manager = app.router.lifespan_context
+    app.router.lifespan_context = _merge_lifespan_context(
+        old_lifespan_manager,
+        _lifespan_manager,
+    )
+    return container
+
+
+async def build_di_container(connection: HTTPConnection) -> typing.AsyncIterator[AsyncContainer]:
+    context: dict[type[typing.Any], typing.Any] = {}
+    scope: Scope | None = None
+    if isinstance(connection, fastapi.Request):
+        scope = Scope.REQUEST
+        context[fastapi.Request] = connection
+    elif isinstance(connection, fastapi.WebSocket):
+        context[fastapi.WebSocket] = connection
+        scope = Scope.SESSION
+    container: AsyncContainer = fetch_di_container(connection.app)
+    async with container.build_child_container(context=context, scope=scope) as request_container:
+        yield request_container
+
+
+@dataclasses.dataclass(slots=True, frozen=True)
+class Dependency(typing.Generic[T_co]):
+    dependency: providers.AbstractProvider[T_co] | type[T_co]
+
+    async def __call__(
+        self, request_container: typing.Annotated[AsyncContainer, fastapi.Depends(build_di_container)]
+    ) -> T_co:
+        if isinstance(self.dependency, providers.AbstractProvider):
+            return await request_container.resolve_provider(self.dependency)
+        return await request_container.resolve(dependency_type=self.dependency)
+
+
+def FromDI(dependency: providers.AbstractProvider[T_co] | type[T_co], *, use_cache: bool = True) -> T_co:  # noqa: N802
+    return typing.cast(T_co, fastapi.Depends(dependency=Dependency(dependency), use_cache=use_cache))

modern_di_fastapi-1.0.0a0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "modern-di-fastapi"
+description = "Modern-DI integration for FastAPI"
+authors = [{ name = "Artur Shiriev", email = "me@shiriev.ru" }]
+requires-python = ">=3.10,<4"
+license = "MIT"
+readme = "README.md"
+keywords = ["DI", "dependency injector", "ioc-container", "FastAPI", "python"]
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = ["fastapi>=0.100", "modern-di>=1"]
+version = "1.0.0a0"
+
+[project.urls]
+repository = "https://github.com/modern-python/modern-di"
+docs = "https://modern-di.readthedocs.io"
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+    "ruff",
+    "mypy",
+    "typing-extensions",
+    "httpx",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build]
+include = ["modern_di_fastapi"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=. --cov-report term-missing"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.coverage.report]
+exclude_also = ["if typing.TYPE_CHECKING:"]