etlantic-fastapi 0.24.0__py3-none-any.whl

etlantic_fastapi/__init__.py

@@ -0,0 +1,116 @@
+"""Thin FastAPI reference adapter for ETLantic authoring/service contracts."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel
+
+from etlantic.service import AuthoringService, PolicyContext
+from fastapi import FastAPI, HTTPException
+
+__version__ = "0.24.0"
+
+
+class DefinitionDocument(BaseModel):
+    document: dict[str, Any]
+    idempotency_key: str | None = None
+
+
+class EditRequest(BaseModel):
+    command: dict[str, Any]
+    expected_token: str | None = None
+
+
+class RunSubmitRequest(BaseModel):
+    idempotency_key: str | None = None
+
+
+def create_reference_app(
+    *,
+    service: AuthoringService | None = None,
+    title: str = "ETLantic Authoring Reference",
+    version: str = "0.24.0",
+) -> FastAPI:
+    """Create a FastAPI app exposing the public authoring/service facade."""
+    svc = service or AuthoringService(policy=PolicyContext())
+    app = FastAPI(title=title, version=version)
+    app.state.service = svc
+
+    @app.get("/negotiation")
+    def negotiation() -> dict[str, Any]:
+        return svc.negotiation()
+
+    @app.get("/catalog")
+    def catalog(definition_id: str | None = None) -> dict[str, Any]:
+        return svc.catalog(definition_id)
+
+    @app.put("/pipelines/{definition_id}")
+    def put_pipeline(definition_id: str, body: DefinitionDocument) -> dict[str, Any]:
+        try:
+            return svc.put_definition(
+                definition_id,
+                body.document,
+                idempotency_key=body.idempotency_key,
+            )
+        except Exception as exc:
+            raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+    @app.get("/pipelines/{definition_id}")
+    def get_pipeline(definition_id: str) -> dict[str, Any]:
+        try:
+            return svc.get_definition(definition_id)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="definition not found") from exc
+
+    @app.post("/pipelines/{definition_id}/edits")
+    def edit_pipeline(definition_id: str, body: EditRequest) -> dict[str, Any]:
+        try:
+            return svc.apply_edit(
+                definition_id, body.command, expected_token=body.expected_token
+            )
+        except Exception as exc:
+            raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+    @app.post("/pipelines/{definition_id}/validate")
+    def validate_pipeline(definition_id: str) -> dict[str, Any]:
+        try:
+            return svc.validate(definition_id)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="definition not found") from exc
+
+    @app.post("/pipelines/{definition_id}/plan")
+    def plan_pipeline(definition_id: str) -> dict[str, Any]:
+        try:
+            return svc.plan(definition_id)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="definition not found") from exc
+
+    @app.post("/pipelines/{definition_id}/runs")
+    def submit_run(
+        definition_id: str, body: RunSubmitRequest | None = None
+    ) -> dict[str, Any]:
+        body = body or RunSubmitRequest()
+        try:
+            return svc.submit_run(definition_id, idempotency_key=body.idempotency_key)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="definition not found") from exc
+
+    @app.get("/runs/{job_id}")
+    def run_status(job_id: str) -> dict[str, Any]:
+        try:
+            return svc.job_status(job_id)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="job not found") from exc
+
+    @app.post("/runs/{job_id}/cancel")
+    def cancel_run(job_id: str) -> dict[str, Any]:
+        try:
+            return svc.cancel_run(job_id)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail="job not found") from exc
+
+    return app
+
+
+__all__ = ["AuthoringService", "PolicyContext", "create_reference_app"]

etlantic_fastapi-0.24.0.dist-info/METADATA

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: etlantic-fastapi
+Version: 0.24.0
+Summary: Thin FastAPI reference adapter for ETLantic 0.24 authoring/service contracts.
+Project-URL: Homepage, https://github.com/eddiethedean/etlantic
+Project-URL: Documentation, https://etlantic.readthedocs.io/
+Project-URL: Repository, https://github.com/eddiethedean/etlantic
+Project-URL: Issues, https://github.com/eddiethedean/etlantic/issues
+Author-email: Odo Matthews <odosmatthews@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: etlantic<0.25,>=0.24.0
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: pydantic<3,>=2.12
+Provides-Extra: test
+Requires-Dist: httpx<1,>=0.27; extra == 'test'
+Description-Content-Type: text/markdown
+
+# etlantic-fastapi
+
+Thin FastAPI reference adapter for the ETLantic 0.24 authoring and service
+contract. Not a production control plane (see 1.1 FastAPI Integration Plan).
+
+```bash
+pip install etlantic-fastapi
+```
+
+```python
+from etlantic_fastapi import create_reference_app
+
+app = create_reference_app()
+```

etlantic_fastapi-0.24.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+etlantic_fastapi/__init__.py,sha256=1XpXE7eiuOEi5jmbgBAuXzt_szXwcLzzkO693XSqUO8,3914
+etlantic_fastapi-0.24.0.dist-info/METADATA,sha256=ZEFo_bepMvdd1bSvli9ZnvawiozXQk3tjypXKrr29Ds,1397
+etlantic_fastapi-0.24.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+etlantic_fastapi-0.24.0.dist-info/RECORD,,

etlantic_fastapi-0.24.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any