engin 0.0.7__tar.gz → 0.0.9__tar.gz

{engin-0.0.7 → engin-0.0.9}/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [0.0.9] - 2025-02-22
+
+### Added
+
+- Dependency class now has a new attribute: `func_name`.
+
+### Changed
+
+- Improved `engin-graph` output.
+- The `module` attribute of dependencies has been renamed to `origin`
+
+### Fixed
+
+- Options provided under the `options` on a Block now have the `block_name` set.
+
+
+## [0.0.8] - 2025-02-22
+
+### Added
+
+- A package script, `engin-graph` for visualising the dependency graph.
+
+
 ## [0.0.7] - 2025-02-20
 
 ### Changed

{engin-0.0.7 → engin-0.0.9}/PKG-INFO

@@ -1,8 +1,14 @@
 Metadata-Version: 2.4
 Name: engin
-Version: 0.0.7
+Version: 0.0.9
 Summary: An async-first modular application framework
+Project-URL: Homepage, https://github.com/invokermain/engin
+Project-URL: Documentation, https://engin.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/invokermain/engin.git
+Project-URL: Changelog, https://github.com/invokermain/engin/blob/main/CHANGELOG.md
+License-Expression: MIT
 License-File: LICENSE
+Keywords: Application Framework,Dependency Injection
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 

{engin-0.0.7 → engin-0.0.9}/examples/asgi/main.py

@@ -12,4 +12,6 @@ logging.basicConfig(level=logging.DEBUG)
 
 app = ASGIEngin(AppBlock(), DatabaseBlock(), CatBlock(), Supply(AppConfig(debug=True)))
 
-uvicorn.run(app)
+
+if __name__ == "__main__":
+    uvicorn.run(app)

engin-0.0.9/examples/fastapi/app.py

@@ -0,0 +1,29 @@
+from fastapi import APIRouter, FastAPI
+from pydantic_settings import BaseSettings
+
+from engin import Block, provide
+
+
+class AppConfig(BaseSettings):
+    debug: bool = False
+
+
+class AppBlock(Block):
+    @provide
+    def default_config(self) -> AppConfig:
+        return AppConfig()
+
+    @provide
+    def app_factory(self, app_config: AppConfig, routers: list[APIRouter]) -> FastAPI:
+        app = FastAPI(debug=app_config.debug)
+
+        for router in routers:
+            app.include_router(router)
+
+        app.add_api_route(path="/health", endpoint=_health)
+
+        return app
+
+
+async def _health() -> dict[str, bool]:
+    return {"ok": True}

{engin-0.0.7 → engin-0.0.9}/examples/fastapi/main.py

@@ -11,4 +11,6 @@ logging.basicConfig(level=logging.DEBUG)
 
 app = FastAPIEngin(AppBlock(), CatBlock(), Supply(AppConfig(debug=True)))
 
-uvicorn.run(app)
+
+if __name__ == "__main__":
+    uvicorn.run(app)

{engin-0.0.7 → engin-0.0.9}/examples/fastapi/routes/cats/block.py

@@ -1,16 +1,14 @@
-from fastapi import FastAPI
+from typing import ClassVar
 
-from engin import Block, invoke, provide
+from engin import Block, Invoke, Provide, Supply, provide
 from examples.fastapi.routes.cats.adapters.repository import InMemoryCatRepository
 from examples.fastapi.routes.cats.api import router
 from examples.fastapi.routes.cats.ports import CatRepository
 
 
 class CatBlock(Block):
+    options: ClassVar[list[Provide | Invoke]] = [Supply([router])]
+
     @provide
     def cat_repository(self) -> CatRepository:
         return InMemoryCatRepository()
-
-    @invoke
-    def attach_router(self, app: FastAPI) -> None:
-        app.include_router(router)

{engin-0.0.7 → engin-0.0.9}/examples/simple/main.py

@@ -19,4 +19,5 @@ async def main(http_client: AsyncClient) -> None:
 
 engin = Engin(Provide(new_httpx_client), Invoke(main))
 
-asyncio.run(engin.run())
+if __name__ == "__main__":
+    asyncio.run(engin.run())

{engin-0.0.7 → engin-0.0.9}/pyproject.toml

@@ -1,11 +1,19 @@
 [project]
 name = "engin"
-version = "0.0.7"
+version = "0.0.9"
 description = "An async-first modular application framework"
 readme = "README.md"
 requires-python = ">=3.10"
+license = "MIT"
+keywords = ["Dependency Injection", "Application Framework"]
 dependencies = []
 
+[project.urls]
+Homepage = "https://github.com/invokermain/engin"
+Documentation = "https://engin.readthedocs.io/en/latest/"
+Repository = "https://github.com/invokermain/engin.git"
+Changelog = "https://github.com/invokermain/engin/blob/main/CHANGELOG.md"
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
@@ -34,6 +42,10 @@ docs = [
 ]
 
 
+[project.scripts]
+engin-graph = "engin.scripts.graph:serve_graph"
+
+
 [tool.ruff]
 line-length = 95
 target-version = "py310"
@@ -54,7 +66,9 @@ ignore = [
 [tool.ruff.lint.per-file-ignores]
 "**/src/*" = ["PT"]
 "**/tests/*" = ["S", "ANN"]
+# allow print statements in examples/scripts
 "**/examples/*" = ["T201"]
+"**/scripts/*" = ["T201"]
 
 
 [tool.pytest.ini_options]

{engin-0.0.7 → engin-0.0.9}/src/engin/_block.py

@@ -59,6 +59,8 @@ class Block(Iterable[Provide | Invoke]):
                     raise RuntimeError("Block option is not an instance of Provide or Invoke")
                 opt.set_block_name(self._name)
                 self._options.append(opt)
+        for opt in self.options:
+            opt.set_block_name(self._name)
 
     @property
     def name(self) -> str:

{engin-0.0.7 → engin-0.0.9}/src/engin/_dependency.py

@@ -18,7 +18,6 @@ from engin._type_utils import TypeId, type_id_of
 P = ParamSpec("P")
 T = TypeVar("T")
 Func: TypeAlias = Callable[P, T]
-_SELF = object()
 
 
 def _noop(*args: Any, **kwargs: Any) -> None: ...
@@ -31,10 +30,24 @@ class Dependency(ABC, Generic[P, T]):
         self._signature = inspect.signature(self._func)
         self._block_name = block_name
 
+    @property
+    def origin(self) -> str:
+        """
+        The module that this Dependency originated from.
+
+        Returns:
+            A string, e.g. "examples.fastapi.app"
+        """
+        return self._func.__module__
+
     @property
     def block_name(self) -> str | None:
         return self._block_name
 
+    @property
+    def func_name(self) -> str:
+        return self._func.__name__
+
     @property
     def name(self) -> str:
         if self._block_name:
@@ -102,6 +115,10 @@ class Entrypoint(Invoke):
         self._type = type_
         super().__init__(invocation=_noop, block_name=block_name)
 
+    @property
+    def origin(self) -> str:
+        return self._type.__module__
+
     @property
     def parameter_types(self) -> list[TypeId]:
         return [type_id_of(self._type)]
@@ -169,6 +186,10 @@ class Supply(Provide, Generic[T]):
             self._get_val.__annotations__["return"] = type_hint
         super().__init__(builder=self._get_val, block_name=block_name)
 
+    @property
+    def origin(self) -> str:
+        return self._value.__module__
+
     @property
     def return_type(self) -> type[T]:
         if self._type_hint is not None:

{engin-0.0.7 → engin-0.0.9}/src/engin/_engin.py

@@ -13,6 +13,7 @@ from engin import Entrypoint
 from engin._assembler import AssembledDependency, Assembler
 from engin._block import Block
 from engin._dependency import Dependency, Invoke, Provide, Supply
+from engin._graph import DependencyGrapher, Node
 from engin._lifecycle import Lifecycle
 from engin._type_utils import TypeId
 
@@ -80,7 +81,6 @@ class Engin:
         Args:
             *options: an instance of Provide, Supply, Invoke, Entrypoint or a Block.
         """
-
         self._stop_requested_event = Event()
         self._stop_complete_event = Event()
         self._exit_stack: AsyncExitStack = AsyncExitStack()
@@ -95,8 +95,6 @@ class Engin:
         self._destruct_options(chain(self._LIB_OPTIONS, options))
         multi_providers = [p for multi in self._multiproviders.values() for p in multi]
         self._assembler = Assembler(chain(self._providers.values(), multi_providers))
-        self._providers.clear()
-        self._multiproviders.clear()
 
     @property
     def assembler(self) -> Assembler:
@@ -162,6 +160,10 @@ class Engin:
             return
         await self._stop_complete_event.wait()
 
+    def graph(self) -> list[Node]:
+        grapher = DependencyGrapher({**self._providers, **self._multiproviders})
+        return grapher.resolve(self._invocations)
+
     async def _shutdown(self) -> None:
         LOG.info("stopping engin")
         await self._exit_stack.aclose()

engin-0.0.9/src/engin/_graph.py

@@ -0,0 +1,50 @@
+from collections.abc import Iterable
+from dataclasses import dataclass
+
+from engin import Provide
+from engin._dependency import Dependency
+from engin._type_utils import TypeId
+
+
+@dataclass(slots=True, frozen=True, kw_only=True)
+class Node:
+    """
+    A Node in the Dependency Graph.
+    """
+
+    node: Dependency
+    parent: Dependency | None
+
+    def __repr__(self) -> str:
+        return f"Node(node={self.node!s},parent={self.parent!s})"
+
+
+class DependencyGrapher:
+    def __init__(self, providers: dict[TypeId, Provide | list[Provide]]) -> None:
+        self._providers: dict[TypeId, Provide | list[Provide]] = providers
+
+    def resolve(self, roots: Iterable[Dependency]) -> list[Node]:
+        return self._resolve_recursive(roots, seen=set())
+
+    def _resolve_recursive(
+        self, roots: Iterable[Dependency], *, seen: set[TypeId]
+    ) -> list[Node]:
+        nodes: list[Node] = []
+        for root in roots:
+            for parameter in root.parameter_types:
+                provider = self._providers[parameter]
+
+                # multiprovider
+                if isinstance(provider, list):
+                    nodes.extend(Node(node=p, parent=root) for p in provider)
+                    if parameter not in seen:
+                        nodes.extend(self._resolve_recursive(provider, seen=seen))
+                # single provider
+                else:
+                    nodes.append(Node(node=provider, parent=root))
+                    if parameter not in seen:
+                        nodes.extend(self._resolve_recursive([provider], seen=seen))
+
+                seen.add(parameter)
+
+        return nodes

{engin-0.0.7 → engin-0.0.9}/src/engin/ext/asgi.py

@@ -2,10 +2,11 @@ import traceback
 from collections.abc import Awaitable, Callable, MutableMapping
 from typing import Any, ClassVar, Protocol, TypeAlias
 
-from engin import Engin, Option
+from engin import Engin, Entrypoint, Option
 
 __all__ = ["ASGIEngin", "ASGIType"]
 
+from engin._graph import DependencyGrapher, Node
 
 _Scope: TypeAlias = MutableMapping[str, Any]
 _Message: TypeAlias = MutableMapping[str, Any]
@@ -49,6 +50,10 @@ class ASGIEngin(Engin, ASGIType):
         await self.start()
         self._asgi_app = await self._assembler.get(self._asgi_type)
 
+    def graph(self) -> list[Node]:
+        grapher = DependencyGrapher({**self._providers, **self._multiproviders})
+        return grapher.resolve([Entrypoint(self._asgi_type), *self._invocations])
+
 
 class _Rereceive:
     def __init__(self, message: _Message) -> None:

engin-0.0.9/src/engin/ext/fastapi.py

@@ -0,0 +1,168 @@
+import inspect
+import typing
+from collections.abc import Iterable
+from inspect import Parameter
+from typing import ClassVar, TypeVar
+
+from fastapi.routing import APIRoute
+
+from engin import Engin, Entrypoint, Invoke, Option
+from engin._dependency import Dependency, Supply
+from engin._graph import DependencyGrapher, Node
+from engin._type_utils import TypeId, type_id_of
+from engin.ext.asgi import ASGIEngin
+
+try:
+    from fastapi import APIRouter, FastAPI
+    from fastapi.params import Depends
+    from starlette.requests import HTTPConnection
+except ImportError as err:
+    raise ImportError(
+        "fastapi package must be installed to use the fastapi extension"
+    ) from err
+
+__all__ = ["APIRouteDependency", "FastAPIEngin", "Inject"]
+
+
+def _attach_engin(
+    app: FastAPI,
+    engin: Engin,
+) -> None:
+    app.state.engin = engin
+
+
+class FastAPIEngin(ASGIEngin):
+    _LIB_OPTIONS: ClassVar[list[Option]] = [*ASGIEngin._LIB_OPTIONS, Invoke(_attach_engin)]
+    _asgi_type = FastAPI
+
+    def graph(self) -> list[Node]:
+        grapher = _FastAPIDependencyGrapher({**self._providers, **self._multiproviders})
+        return grapher.resolve(
+            [
+                Entrypoint(self._asgi_type),
+                *[i for i in self._invocations if i.func_name != "_attach_engin"],
+            ]
+        )
+
+
+T = TypeVar("T")
+
+
+def Inject(interface: type[T]) -> Depends:
+    async def inner(conn: HTTPConnection) -> T:
+        engin: Engin = conn.app.state.engin
+        return await engin.assembler.get(interface)
+
+    dep = Depends(inner)
+    dep.__engin__ = True  # type: ignore[attr-defined]
+    return dep
+
+
+class _FastAPIDependencyGrapher(DependencyGrapher):
+    """
+    This exists in order to bridge the gap between
+    """
+
+    def _resolve_recursive(
+        self, roots: Iterable[Dependency], *, seen: set[TypeId]
+    ) -> list[Node]:
+        nodes: list[Node] = []
+        for root in roots:
+            for parameter in root.parameter_types:
+                provider = self._providers[parameter]
+
+                # multiprovider
+                if isinstance(provider, list):
+                    for p in provider:
+                        nodes.append(Node(node=p, parent=root))
+
+                        if isinstance(p, Supply):
+                            route_dependencies = _extract_routes_from_supply(p)
+                            nodes.extend(
+                                Node(node=route_dependency, parent=p)
+                                for route_dependency in route_dependencies
+                            )
+                            nodes.extend(
+                                self._resolve_recursive(route_dependencies, seen=seen)
+                            )
+
+                        if parameter not in seen:
+                            nodes.extend(self._resolve_recursive(provider, seen=seen))
+                # single provider
+                else:
+                    nodes.append(Node(node=provider, parent=root))
+                    # not sure why anyone would ever supply a single APIRouter in an
+                    # application, but just in case
+                    if isinstance(provider, Supply):
+                        route_dependencies = _extract_routes_from_supply(provider)
+                        nodes.extend(
+                            Node(node=route_dependency, parent=provider)
+                            for route_dependency in route_dependencies
+                        )
+                        nodes.extend(self._resolve_recursive(route_dependencies, seen=seen))
+                    if parameter not in seen:
+                        nodes.extend(self._resolve_recursive([provider], seen=seen))
+
+                seen.add(parameter)
+
+        return nodes
+
+
+def _extract_routes_from_supply(supply: Supply) -> list[Dependency]:
+    if supply.is_multiprovider:
+        inner = supply._value[0]
+        if isinstance(inner, APIRouter):
+            return [
+                APIRouteDependency(route, block_name=supply.block_name)
+                for route in inner.routes
+                if isinstance(route, APIRoute)
+            ]
+    return []
+
+
+class APIRouteDependency(Dependency):
+    """
+    This is a pseudo-dependency that is only used when calling FastAPIEngin.graph() in
+    order to provide richer metadata to the Node.
+
+    This class should never be constructed in application code.
+    """
+
+    def __init__(self, route: APIRoute, block_name: str | None = None) -> None:
+        """
+        Warning: this should never be constructed in application code.
+        """
+        self._route = route
+        self._signature = inspect.signature(route.endpoint)
+        self._block_name = block_name
+
+    @property
+    def route(self) -> APIRoute:
+        return self._route
+
+    @property
+    def parameter_types(self) -> list[TypeId]:
+        parameters = list(self._signature.parameters.values())
+        if not parameters:
+            return []
+        if parameters[0].name == "self":
+            parameters.pop(0)
+        return [
+            type_id_of(typing.get_args(param.annotation)[0])
+            for param in parameters
+            if self._is_injected_param(param)
+        ]
+
+    @staticmethod
+    def _is_injected_param(param: Parameter) -> bool:
+        if typing.get_origin(param.annotation) != typing.Annotated:
+            return False
+        args = typing.get_args(param.annotation)
+        if len(args) != 2:
+            return False
+        return isinstance(args[1], Depends) and hasattr(args[1], "__engin__")
+
+    @property
+    def name(self) -> str:
+        methods = ",".join(self._route.methods)
+        return f"{methods} {self._route.path}"

engin-0.0.9/src/engin/scripts/graph.py

@@ -0,0 +1,174 @@
+import importlib
+import logging
+import socketserver
+import sys
+import threading
+from argparse import ArgumentParser
+from http.server import BaseHTTPRequestHandler
+from time import sleep
+from typing import Any
+
+from engin import Engin, Entrypoint, Invoke
+from engin._dependency import Dependency, Provide, Supply
+from engin.ext.asgi import ASGIEngin
+from engin.ext.fastapi import APIRouteDependency
+
+# mute logging from importing of files + engin's debug logging.
+logging.disable()
+
+args = ArgumentParser(
+    prog="engin-graph",
+    description="Creates a visualisation of your application's dependencies",
+)
+args.add_argument(
+    "app",
+    help=(
+        "the import path of your Engin instance, in the form "
+        "'package:application', e.g. 'app.main:engin'"
+    ),
+)
+
+
+def serve_graph() -> None:
+    # add cwd to path to enable local package imports
+    sys.path.insert(0, "")
+
+    parsed = args.parse_args()
+
+    app = parsed.app
+
+    try:
+        module_name, engin_name = app.split(":", maxsplit=1)
+    except ValueError:
+        raise ValueError(
+            "Expected an argument of the form 'module:attribute', e.g. 'myapp:engin'"
+        ) from None
+
+    module = importlib.import_module(module_name)
+
+    try:
+        instance = getattr(module, engin_name)
+    except LookupError:
+        raise LookupError(f"Module '{module_name}' has no attribute '{engin_name}'") from None
+
+    if not isinstance(instance, Engin):
+        raise TypeError(f"'{app}' is not an Engin instance")
+
+    nodes = instance.graph()
+
+    # transform dependencies into mermaid syntax
+    dependencies = [
+        f"{_render_node(node.parent)} --> {_render_node(node.node)}"
+        for node in nodes
+        if node.parent is not None
+    ]
+
+    html = (
+        _GRAPH_HTML.replace("%%DATA%%", "\n".join(dependencies))
+        .replace(
+            "%%LEGEND%%",
+            ASGI_ENGIN_LEGEND if isinstance(instance, ASGIEngin) else DEFAULT_LEGEND,
+        )
+        .encode("utf8")
+    )
+
+    class Handler(BaseHTTPRequestHandler):
+        def do_GET(self) -> None:
+            self.send_response(200, "OK")
+            self.send_header("Content-type", "html")
+            self.end_headers()
+            self.wfile.write(html)
+
+        def log_message(self, format: str, *args: Any) -> None:
+            return
+
+    def _start_server() -> None:
+        with socketserver.TCPServer(("localhost", 8123), Handler) as httpd:
+            print("Serving dependency graph on http://localhost:8123")
+            httpd.serve_forever()
+
+    server_thread = threading.Thread(target=_start_server)
+    server_thread.daemon = True  # Daemonize the thread so it exits when the main script exits
+    server_thread.start()
+
+    try:
+        sleep(10000)
+    except KeyboardInterrupt:
+        print("Exiting the server...")
+
+
+_BLOCK_IDX: dict[str, int] = {}
+_SEEN_BLOCKS: list[str] = []
+
+
+def _render_node(node: Dependency) -> str:
+    node_id = id(node)
+    md = ""
+    style = ""
+
+    # format block name
+    if n := node.block_name:
+        md += f"_{n}_\n"
+        if n not in _BLOCK_IDX:
+            _BLOCK_IDX[n] = len(_SEEN_BLOCKS) % 8
+            _SEEN_BLOCKS.append(n)
+        style = f":::b{_BLOCK_IDX[n]}"
+
+    if isinstance(node, Supply):
+        md += f"{node.return_type_id}"
+        return f'{node_id}("`{md}`"){style}'
+    if isinstance(node, Provide):
+        md += f"{node.return_type_id}"
+        return f'{node_id}["`{md}`"]{style}'
+    if isinstance(node, Entrypoint):
+        entrypoint_type = node.parameter_types[0]
+        md += f"{entrypoint_type}"
+        return f'{node_id}[/"`{md}`"\\]{style}'
+    if isinstance(node, Invoke):
+        md += f"{node.func_name}"
+        return f'{node_id}[/"`{md}`"/]{style}'
+    if isinstance(node, APIRouteDependency):
+        md += f"{node.name}"
+        return f'{node_id}[["`{md}`"]]{style}'
+    else:
+        return f'{node_id}["`{node.name}`"]{style}'
+
+
+_GRAPH_HTML = """
+<!doctype html>
+<html lang="en">
+  <body>
+    <div style="border-style:outset">
+        <p>LEGEND</p>
+        <pre class="mermaid">
+          graph LR
+            %%LEGEND%%
+            classDef b0 fill:#7fc97f;
+        </pre>
+    </div>
+    <pre class="mermaid">
+      graph TD
+          %%DATA%%
+          classDef b0 fill:#7fc97f;
+          classDef b1 fill:#beaed4;
+          classDef b2 fill:#fdc086;
+          classDef b3 fill:#ffff99;
+          classDef b4 fill:#386cb0;
+          classDef b5 fill:#f0027f;
+          classDef b6 fill:#bf5b17;
+          classDef b7 fill:#666666;
+    </pre>
+    <script type="module">
+      import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
+      let config = { flowchart: { useMaxWidth: false, htmlLabels: true } };
+      mermaid.initialize(config);
+    </script>
+  </body>
+</html>
+"""
+
+DEFAULT_LEGEND = (
+    "0[/Invoke/] ~~~ 1[/Entrypoint\\] ~~~ 2[Provide] ~~~ 3(Supply)"
+    ' ~~~ 4["`Block Grouping`"]:::b0'
+)
+ASGI_ENGIN_LEGEND = DEFAULT_LEGEND + " ~~~ 5[[API Route]]"

{engin-0.0.7 → engin-0.0.9}/tests/test_engin.py

@@ -136,3 +136,23 @@ async def test_engin_with_lifecycle_using_run():
     await asyncio.gather(engin.run(), _stop_task())
     # lifecycle should have stopped by now
     assert state == 2
+
+
+def test_engin_graph():
+    def a() -> A:
+        return A()
+
+    def b(_: A) -> B:
+        return B()
+
+    def c(_: B) -> C:
+        return C()
+
+    def main(c: C) -> None:
+        assert isinstance(c, C)
+
+    engin = Engin(Provide(a), Provide(b), Provide(c), Invoke(main))
+
+    graph = engin.graph()
+
+    assert len(graph) == 3

{engin-0.0.7 → engin-0.0.9}/uv.lock

@@ -1,4 +1,5 @@
 version = 1
+revision = 1
 requires-python = ">=3.10"
 
 [[package]]
@@ -127,7 +128,7 @@ wheels = [
 
 [[package]]
 name = "engin"
-version = "0.0.6"
+version = "0.0.8"
 source = { editable = "." }
 
 [package.dev-dependencies]
@@ -414,7 +415,7 @@ wheels = [
 
 [[package]]
 name = "mkdocs-material"
-version = "9.6.4"
+version = "9.6.5"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "babel" },
@@ -429,9 +430,9 @@ dependencies = [
     { name = "regex" },
     { name = "requests" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/9b/80/4efbd3df76c6c1ec27130b43662612f9033adc5a4166f1df2acb8dd6fb1b/mkdocs_material-9.6.4.tar.gz", hash = "sha256:4d1d35e1c1d3e15294cb7fa5d02e0abaee70d408f75027dc7be6e30fb32e6867", size = 3942628 }
+sdist = { url = "https://files.pythonhosted.org/packages/38/4d/0a9f6f604f01eaa43df3b3b30b5218548efd7341913b302815585f48abb2/mkdocs_material-9.6.5.tar.gz", hash = "sha256:b714679a8c91b0ffe2188e11ed58c44d2523e9c2ae26a29cc652fa7478faa21f", size = 3946479 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5b/a5/f3c0e86c1d28fe04f1b724700ff3dd8b3647c89df03a8e10c4bc6b4db1b8/mkdocs_material-9.6.4-py3-none-any.whl", hash = "sha256:414e8376551def6d644b8e6f77226022868532a792eb2c9accf52199009f568f", size = 8688727 },
+    { url = "https://files.pythonhosted.org/packages/3d/05/7d440b23454c0fc8cdba21f73ce23369eb16e7f7ee475fac3a4ad15ad5e0/mkdocs_material-9.6.5-py3-none-any.whl", hash = "sha256:aad3e6fb860c20870f75fb2a69ef901f1be727891e41adb60b753efcae19453b", size = 8695060 },
 ]
 
 [[package]]
@@ -468,7 +469,7 @@ python = [
 
 [[package]]
 name = "mkdocstrings-python"
-version = "1.15.0"
+version = "1.16.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "griffe" },
@@ -476,9 +477,9 @@ dependencies = [
     { name = "mkdocstrings" },
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/28/5e/ea531f1798d6b614f87b7a1191f8bfda864767adecef3c75ec87f30e0a3d/mkdocstrings_python-1.15.0.tar.gz", hash = "sha256:2bfecbbe1252c67281408a6567d59545f4979931110f01ab625aa8c227c06edc", size = 422613 }
+sdist = { url = "https://files.pythonhosted.org/packages/82/a4/3475fd03f3d566ca05872cec76a86d94ead23d99bbf6a89035b924a3e9b6/mkdocstrings_python-1.16.1.tar.gz", hash = "sha256:d7152d17da74d3616a0f17df5d2da771ecf7340518c158650e5a64a0a95973f4", size = 423399 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6f/d7/1d35cce198f76e8ae4010a71ff5acabe8b75aeb35f8c3d920e175a6476ca/mkdocstrings_python-1.15.0-py3-none-any.whl", hash = "sha256:77aced1bb28840d7d3510f77353319eeb450961880d87f9c53fdab331ba0120d", size = 449068 },
+    { url = "https://files.pythonhosted.org/packages/00/f7/433201c48d4b59208dcbae6e1481febdf732ae20ecb2aee84a4ea142f043/mkdocstrings_python-1.16.1-py3-none-any.whl", hash = "sha256:b88ff6fc6a293cee9cb42313f1cba37a2c5cdf37bcc60b241ec7ab66b5d41b58", size = 449139 },
 ]
 
 [[package]]
@@ -687,15 +688,15 @@ wheels = [
 
 [[package]]
 name = "pydantic-settings"
-version = "2.7.1"
+version = "2.8.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
     { name = "python-dotenv" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/73/7b/c58a586cd7d9ac66d2ee4ba60ca2d241fa837c02bca9bea80a9a8c3d22a9/pydantic_settings-2.7.1.tar.gz", hash = "sha256:10c9caad35e64bfb3c2fbf70a078c0e25cc92499782e5200747f942a065dec93", size = 79920 }
+sdist = { url = "https://files.pythonhosted.org/packages/ca/a2/ad2511ede77bb424f3939e5148a56d968cdc6b1462620d24b2a1f4ab65b4/pydantic_settings-2.8.0.tar.gz", hash = "sha256:88e2ca28f6e68ea102c99c3c401d6c9078e68a5df600e97b43891c34e089500a", size = 83347 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b4/46/93416fdae86d40879714f72956ac14df9c7b76f7d41a4d68aa9f71a0028b/pydantic_settings-2.7.1-py3-none-any.whl", hash = "sha256:590be9e6e24d06db33a4262829edef682500ef008565a969c73d39d5f8bfb3fd", size = 29718 },
+    { url = "https://files.pythonhosted.org/packages/c1/a9/3b9642025174bbe67e900785fb99c9bfe91ea584b0b7126ff99945c24a0e/pydantic_settings-2.8.0-py3-none-any.whl", hash = "sha256:c782c7dc3fb40e97b238e713c25d26f64314aece2e91abcff592fcac15f71820", size = 30746 },
 ]
 
 [[package]]
@@ -912,27 +913,27 @@ wheels = [
 
 [[package]]
 name = "ruff"
-version = "0.9.6"
+version = "0.9.7"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/2a/e1/e265aba384343dd8ddd3083f5e33536cd17e1566c41453a5517b5dd443be/ruff-0.9.6.tar.gz", hash = "sha256:81761592f72b620ec8fa1068a6fd00e98a5ebee342a3642efd84454f3031dca9", size = 3639454 }
+sdist = { url = "https://files.pythonhosted.org/packages/39/8b/a86c300359861b186f18359adf4437ac8e4c52e42daa9eedc731ef9d5b53/ruff-0.9.7.tar.gz", hash = "sha256:643757633417907510157b206e490c3aa11cab0c087c912f60e07fbafa87a4c6", size = 3669813 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/76/e3/3d2c022e687e18cf5d93d6bfa2722d46afc64eaa438c7fbbdd603b3597be/ruff-0.9.6-py3-none-linux_armv6l.whl", hash = "sha256:2f218f356dd2d995839f1941322ff021c72a492c470f0b26a34f844c29cdf5ba", size = 11714128 },
-    { url = "https://files.pythonhosted.org/packages/e1/22/aff073b70f95c052e5c58153cba735748c9e70107a77d03420d7850710a0/ruff-0.9.6-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:b908ff4df65dad7b251c9968a2e4560836d8f5487c2f0cc238321ed951ea0504", size = 11682539 },
-    { url = "https://files.pythonhosted.org/packages/75/a7/f5b7390afd98a7918582a3d256cd3e78ba0a26165a467c1820084587cbf9/ruff-0.9.6-py3-none-macosx_11_0_arm64.whl", hash = "sha256:b109c0ad2ececf42e75fa99dc4043ff72a357436bb171900714a9ea581ddef83", size = 11132512 },
-    { url = "https://files.pythonhosted.org/packages/a6/e3/45de13ef65047fea2e33f7e573d848206e15c715e5cd56095589a7733d04/ruff-0.9.6-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1de4367cca3dac99bcbd15c161404e849bb0bfd543664db39232648dc00112dc", size = 11929275 },
-    { url = "https://files.pythonhosted.org/packages/7d/f2/23d04cd6c43b2e641ab961ade8d0b5edb212ecebd112506188c91f2a6e6c/ruff-0.9.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac3ee4d7c2c92ddfdaedf0bf31b2b176fa7aa8950efc454628d477394d35638b", size = 11466502 },
-    { url = "https://files.pythonhosted.org/packages/b5/6f/3a8cf166f2d7f1627dd2201e6cbc4cb81f8b7d58099348f0c1ff7b733792/ruff-0.9.6-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5dc1edd1775270e6aa2386119aea692039781429f0be1e0949ea5884e011aa8e", size = 12676364 },
-    { url = "https://files.pythonhosted.org/packages/f5/c4/db52e2189983c70114ff2b7e3997e48c8318af44fe83e1ce9517570a50c6/ruff-0.9.6-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:4a091729086dffa4bd070aa5dab7e39cc6b9d62eb2bef8f3d91172d30d599666", size = 13335518 },
-    { url = "https://files.pythonhosted.org/packages/66/44/545f8a4d136830f08f4d24324e7db957c5374bf3a3f7a6c0bc7be4623a37/ruff-0.9.6-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d1bbc6808bf7b15796cef0815e1dfb796fbd383e7dbd4334709642649625e7c5", size = 12823287 },
-    { url = "https://files.pythonhosted.org/packages/c5/26/8208ef9ee7431032c143649a9967c3ae1aae4257d95e6f8519f07309aa66/ruff-0.9.6-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:589d1d9f25b5754ff230dce914a174a7c951a85a4e9270613a2b74231fdac2f5", size = 14592374 },
-    { url = "https://files.pythonhosted.org/packages/31/70/e917781e55ff39c5b5208bda384fd397ffd76605e68544d71a7e40944945/ruff-0.9.6-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dc61dd5131742e21103fbbdcad683a8813be0e3c204472d520d9a5021ca8b217", size = 12500173 },
-    { url = "https://files.pythonhosted.org/packages/84/f5/e4ddee07660f5a9622a9c2b639afd8f3104988dc4f6ba0b73ffacffa9a8c/ruff-0.9.6-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:5e2d9126161d0357e5c8f30b0bd6168d2c3872372f14481136d13de9937f79b6", size = 11906555 },
-    { url = "https://files.pythonhosted.org/packages/f1/2b/6ff2fe383667075eef8656b9892e73dd9b119b5e3add51298628b87f6429/ruff-0.9.6-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:68660eab1a8e65babb5229a1f97b46e3120923757a68b5413d8561f8a85d4897", size = 11538958 },
-    { url = "https://files.pythonhosted.org/packages/3c/db/98e59e90de45d1eb46649151c10a062d5707b5b7f76f64eb1e29edf6ebb1/ruff-0.9.6-py3-none-musllinux_1_2_i686.whl", hash = "sha256:c4cae6c4cc7b9b4017c71114115db0445b00a16de3bcde0946273e8392856f08", size = 12117247 },
-    { url = "https://files.pythonhosted.org/packages/ec/bc/54e38f6d219013a9204a5a2015c09e7a8c36cedcd50a4b01ac69a550b9d9/ruff-0.9.6-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:19f505b643228b417c1111a2a536424ddde0db4ef9023b9e04a46ed8a1cb4656", size = 12554647 },
-    { url = "https://files.pythonhosted.org/packages/a5/7d/7b461ab0e2404293c0627125bb70ac642c2e8d55bf590f6fce85f508f1b2/ruff-0.9.6-py3-none-win32.whl", hash = "sha256:194d8402bceef1b31164909540a597e0d913c0e4952015a5b40e28c146121b5d", size = 9949214 },
-    { url = "https://files.pythonhosted.org/packages/ee/30/c3cee10f915ed75a5c29c1e57311282d1a15855551a64795c1b2bbe5cf37/ruff-0.9.6-py3-none-win_amd64.whl", hash = "sha256:03482d5c09d90d4ee3f40d97578423698ad895c87314c4de39ed2af945633caa", size = 10999914 },
-    { url = "https://files.pythonhosted.org/packages/e8/a8/d71f44b93e3aa86ae232af1f2126ca7b95c0f515ec135462b3e1f351441c/ruff-0.9.6-py3-none-win_arm64.whl", hash = "sha256:0e2bb706a2be7ddfea4a4af918562fdc1bcb16df255e5fa595bbd800ce322a5a", size = 10177499 },
+    { url = "https://files.pythonhosted.org/packages/b1/f3/3a1d22973291226df4b4e2ff70196b926b6f910c488479adb0eeb42a0d7f/ruff-0.9.7-py3-none-linux_armv6l.whl", hash = "sha256:99d50def47305fe6f233eb8dabfd60047578ca87c9dcb235c9723ab1175180f4", size = 11774588 },
+    { url = "https://files.pythonhosted.org/packages/8e/c9/b881f4157b9b884f2994fd08ee92ae3663fb24e34b0372ac3af999aa7fc6/ruff-0.9.7-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:d59105ae9c44152c3d40a9c40d6331a7acd1cdf5ef404fbe31178a77b174ea66", size = 11746848 },
+    { url = "https://files.pythonhosted.org/packages/14/89/2f546c133f73886ed50a3d449e6bf4af27d92d2f960a43a93d89353f0945/ruff-0.9.7-py3-none-macosx_11_0_arm64.whl", hash = "sha256:f313b5800483770bd540cddac7c90fc46f895f427b7820f18fe1822697f1fec9", size = 11177525 },
+    { url = "https://files.pythonhosted.org/packages/d7/93/6b98f2c12bf28ab9def59c50c9c49508519c5b5cfecca6de871cf01237f6/ruff-0.9.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:042ae32b41343888f59c0a4148f103208bf6b21c90118d51dc93a68366f4e903", size = 11996580 },
+    { url = "https://files.pythonhosted.org/packages/8e/3f/b3fcaf4f6d875e679ac2b71a72f6691a8128ea3cb7be07cbb249f477c061/ruff-0.9.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:87862589373b33cc484b10831004e5e5ec47dc10d2b41ba770e837d4f429d721", size = 11525674 },
+    { url = "https://files.pythonhosted.org/packages/f0/48/33fbf18defb74d624535d5d22adcb09a64c9bbabfa755bc666189a6b2210/ruff-0.9.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a17e1e01bee0926d351a1ee9bc15c445beae888f90069a6192a07a84af544b6b", size = 12739151 },
+    { url = "https://files.pythonhosted.org/packages/63/b5/7e161080c5e19fa69495cbab7c00975ef8a90f3679caa6164921d7f52f4a/ruff-0.9.7-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:7c1f880ac5b2cbebd58b8ebde57069a374865c73f3bf41f05fe7a179c1c8ef22", size = 13416128 },
+    { url = "https://files.pythonhosted.org/packages/4e/c8/b5e7d61fb1c1b26f271ac301ff6d9de5e4d9a9a63f67d732fa8f200f0c88/ruff-0.9.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e63fc20143c291cab2841dbb8260e96bafbe1ba13fd3d60d28be2c71e312da49", size = 12870858 },
+    { url = "https://files.pythonhosted.org/packages/da/cb/2a1a8e4e291a54d28259f8fc6a674cd5b8833e93852c7ef5de436d6ed729/ruff-0.9.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:91ff963baed3e9a6a4eba2a02f4ca8eaa6eba1cc0521aec0987da8d62f53cbef", size = 14786046 },
+    { url = "https://files.pythonhosted.org/packages/ca/6c/c8f8a313be1943f333f376d79724260da5701426c0905762e3ddb389e3f4/ruff-0.9.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:88362e3227c82f63eaebf0b2eff5b88990280fb1ecf7105523883ba8c3aaf6fb", size = 12550834 },
+    { url = "https://files.pythonhosted.org/packages/9d/ad/f70cf5e8e7c52a25e166bdc84c082163c9c6f82a073f654c321b4dff9660/ruff-0.9.7-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:0372c5a90349f00212270421fe91874b866fd3626eb3b397ede06cd385f6f7e0", size = 11961307 },
+    { url = "https://files.pythonhosted.org/packages/52/d5/4f303ea94a5f4f454daf4d02671b1fbfe2a318b5fcd009f957466f936c50/ruff-0.9.7-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:d76b8ab60e99e6424cd9d3d923274a1324aefce04f8ea537136b8398bbae0a62", size = 11612039 },
+    { url = "https://files.pythonhosted.org/packages/eb/c8/bd12a23a75603c704ce86723be0648ba3d4ecc2af07eecd2e9fa112f7e19/ruff-0.9.7-py3-none-musllinux_1_2_i686.whl", hash = "sha256:0c439bdfc8983e1336577f00e09a4e7a78944fe01e4ea7fe616d00c3ec69a3d0", size = 12168177 },
+    { url = "https://files.pythonhosted.org/packages/cc/57/d648d4f73400fef047d62d464d1a14591f2e6b3d4a15e93e23a53c20705d/ruff-0.9.7-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:115d1f15e8fdd445a7b4dc9a30abae22de3f6bcabeb503964904471691ef7606", size = 12610122 },
+    { url = "https://files.pythonhosted.org/packages/49/79/acbc1edd03ac0e2a04ae2593555dbc9990b34090a9729a0c4c0cf20fb595/ruff-0.9.7-py3-none-win32.whl", hash = "sha256:e9ece95b7de5923cbf38893f066ed2872be2f2f477ba94f826c8defdd6ec6b7d", size = 9988751 },
+    { url = "https://files.pythonhosted.org/packages/6d/95/67153a838c6b6ba7a2401241fd8a00cd8c627a8e4a0491b8d853dedeffe0/ruff-0.9.7-py3-none-win_amd64.whl", hash = "sha256:3770fe52b9d691a15f0b87ada29c45324b2ace8f01200fb0c14845e499eb0c2c", size = 11002987 },
+    { url = "https://files.pythonhosted.org/packages/63/6a/aca01554949f3a401991dc32fe22837baeaccb8a0d868256cbb26a029778/ruff-0.9.7-py3-none-win_arm64.whl", hash = "sha256:b075a700b2533feb7a01130ff656a4ec0d5f340bb540ad98759b8401c32c2037", size = 10177763 },
 ]
 
 [[package]]

engin-0.0.7/examples/fastapi/app.py

@@ -1,25 +0,0 @@
-from fastapi import FastAPI
-from pydantic_settings import BaseSettings
-
-from engin import Block, invoke, provide
-
-
-class AppConfig(BaseSettings):
-    debug: bool = False
-
-
-class AppBlock(Block):
-    @provide
-    def app_factory(self, app_config: AppConfig) -> FastAPI:
-        return FastAPI(debug=app_config.debug)
-
-    @provide
-    def default_config(self) -> AppConfig:
-        return AppConfig()
-
-    @invoke
-    def add_health_endpoint(self, app: FastAPI) -> None:
-        async def health() -> dict[str, bool]:
-            return {"ok": True}
-
-        app.add_api_route(path="/health", endpoint=health)

engin-0.0.7/src/engin/ext/fastapi.py

@@ -1,38 +0,0 @@
-from typing import ClassVar, TypeVar
-
-from engin import Engin, Invoke, Option
-from engin.ext.asgi import ASGIEngin
-
-try:
-    from fastapi import FastAPI
-    from fastapi.params import Depends
-    from starlette.requests import HTTPConnection
-except ImportError as err:
-    raise ImportError(
-        "fastapi package must be installed to use the fastapi extension"
-    ) from err
-
-__all__ = ["FastAPIEngin", "Inject"]
-
-
-def _attach_engin(
-    app: FastAPI,
-    engin: Engin,
-) -> None:
-    app.state.engin = engin
-
-
-class FastAPIEngin(ASGIEngin):
-    _LIB_OPTIONS: ClassVar[list[Option]] = [*ASGIEngin._LIB_OPTIONS, Invoke(_attach_engin)]
-    _asgi_type = FastAPI
-
-
-T = TypeVar("T")
-
-
-def Inject(interface: type[T]) -> Depends:
-    async def inner(conn: HTTPConnection) -> T:
-        engin: Engin = conn.app.state.engin
-        return await engin.assembler.get(interface)
-
-    return Depends(inner)