interloper-api 0.67.0__tar.gz → 0.69.0__tar.gz

{interloper_api-0.67.0 → interloper_api-0.69.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: interloper-api
-Version: 0.67.0
+Version: 0.69.0
 Summary: Interloper FastAPI routes
 Author: Guillaume Onfroy
 Author-email: Guillaume Onfroy <guillaume@digitlcloud.com>

{interloper_api-0.67.0 → interloper_api-0.69.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "interloper-api"
-version = "0.67.0"
+version = "0.69.0"
 description = "Interloper FastAPI routes"
 readme = "README.md"
 requires-python = ">=3.10"

{interloper_api-0.67.0 → interloper_api-0.69.0}/pyproject.toml.orig

@@ -3,7 +3,7 @@
 # ###############
 [project]
 name = "interloper-api"
-version = "0.67.0"
+version = "0.69.0"
 description = "Interloper FastAPI routes"
 readme = "README.md"
 authors = [{ name = "Guillaume Onfroy", email = "guillaume@digitlcloud.com" }]

{interloper_api-0.67.0 → interloper_api-0.69.0}/src/interloper_api/routes/backfills.py

@@ -36,11 +36,19 @@ class BackfillCreateRequest(BaseModel):
 
 
 class BackfillResponse(BaseModel):
-    """Response body for a backfill."""
+    """Response body for a backfill.
+
+    The target component's identity is resolved server-side, same contract
+    as ``RunResponse``: the ``component_*`` identity fields are ``None``
+    exactly when the target was deleted.
+    """
 
     id: UUID
     org_id: UUID
     component_id: UUID | None
+    component_kind: str | None = None
+    component_key: str | None = None
+    component_name: str | None = None
     status: str
     start_key: str
     end_key: str
@@ -56,7 +64,7 @@ class BackfillResponse(BaseModel):
         """Convert a DB Backfill to a BackfillResponse.
 
         Args:
-            backfill: The DB Backfill row.
+            backfill: The DB Backfill row, with its ``target`` relationship loaded.
 
         Returns:
             The response model.
@@ -65,6 +73,9 @@ class BackfillResponse(BaseModel):
             id=backfill.id,
             org_id=backfill.org_id,
             component_id=backfill.component_id,
+            component_kind=backfill.target.kind if backfill.target else None,
+            component_key=backfill.target.key if backfill.target else None,
+            component_name=backfill.target.name if backfill.target else None,
             status=backfill.status,
             start_key=backfill.start_key,
             end_key=backfill.end_key,

{interloper_api-0.67.0 → interloper_api-0.69.0}/src/interloper_api/routes/runs.py

@@ -7,7 +7,6 @@ from typing import Annotated, Literal
 from uuid import UUID
 
 from fastapi import APIRouter, Depends, HTTPException, Query, Response
-from interloper.component import KINDS
 from interloper.errors import NotFoundError
 from interloper_db import Profile, Store
 from interloper_db.models import Event, Run
@@ -34,11 +33,21 @@ MAX_EVENTS_PAGE_SIZE = 1000
 
 
 class RunResponse(BaseModel):
-    """Response body for a run."""
+    """Response body for a run.
+
+    The target component's identity is resolved server-side (the row is
+    eagerly joined), so clients never need a second lookup — including for
+    target kinds they do not know about. All three ``component_*`` identity
+    fields are ``None`` exactly when the target was deleted
+    (``component_id`` nulls on deletion).
+    """
 
     id: UUID
     org_id: UUID
     component_id: UUID | None
+    component_kind: str | None = None
+    component_key: str | None = None
+    component_name: str | None = None
     backfill_id: UUID | None
     partition_key: str | None
     status: str
@@ -54,7 +63,7 @@ class RunResponse(BaseModel):
         """Convert a DB Run to a RunResponse.
 
         Args:
-            run: The DB Run row.
+            run: The DB Run row, with its ``target`` relationship loaded.
 
         Returns:
             The response model.
@@ -63,6 +72,9 @@ class RunResponse(BaseModel):
             id=run.id,
             org_id=run.org_id,
             component_id=run.component_id,
+            component_kind=run.target.kind if run.target else None,
+            component_key=run.target.key if run.target else None,
+            component_name=run.target.name if run.target else None,
             backfill_id=run.backfill_id,
             partition_key=run.partition_key,
             status=run.status,
@@ -88,13 +100,13 @@ class RetryRequest(BaseModel):
     scope: Literal["all", "failed"] = "all"
 
 
-class AssetExecutionResponse(BaseModel):
-    """Response body for an asset execution (from the asset_executions view)."""
+class ExecutionResponse(BaseModel):
+    """Response body for an operation execution (from the ``executions`` view)."""
 
     run_id: UUID
     org_id: UUID
-    asset_id: UUID | None = None
-    asset_key: str
+    component_id: UUID | None = None
+    component_key: str
     status: str
     started_at: str | None = None
     completed_at: str | None = None
@@ -238,7 +250,7 @@ def create_run(
     user: Profile = Depends(get_current_user),
     store: Store = Depends(get_store),
 ) -> RunResponse:
-    """Queue a single run targeting a runnable component (job, source, or asset).
+    """Queue a single run targeting a component whose kind declares an operation.
 
     Args:
         body: The component to run and the partition key to run it for.
@@ -249,12 +261,10 @@ def create_run(
         The queued run, as a response model.
 
     Raises:
-        HTTPException: 400 if the component's kind is not runnable, or if the
-            store rejects the run.
+        HTTPException: 400 if the store rejects the run (a kind with no
+            operation, or an invalid partition key).
     """
     target = load_authorized(store.components.get, body.component_id, user, store, label="Component", minimum="editor")
-    if not KINDS[target.kind].runnable:
-        raise HTTPException(status_code=400, detail=f"Components of kind '{target.kind}' cannot be run")
     try:
         run = store.runs.create(target.org_id, component_id=body.component_id, partition_key=body.partition_key)
     except ValueError as e:
@@ -282,13 +292,13 @@ def get_run(
     return RunResponse.from_run(run)
 
 
-@router.get("/{run_id}/asset-executions")
-def list_asset_executions(
+@router.get("/{run_id}/executions")
+def list_executions(
     run_id: UUID,
     user: Profile = Depends(get_current_user),
     store: Store = Depends(get_store),
-) -> list[AssetExecutionResponse]:
-    """List asset executions for a run.
+) -> list[ExecutionResponse]:
+    """List operation executions for a run.
 
     Args:
         run_id: The run UUID.
@@ -296,16 +306,16 @@ def list_asset_executions(
         store: The Store instance.
 
     Returns:
-        The run's asset executions, as response models.
+        The run's operation executions, as response models.
     """
     _load_authorized_run(run_id, user, store)
-    rows = store.events.list_asset_executions(run_id)
+    rows = store.events.list_executions(run_id)
     return [
-        AssetExecutionResponse(
+        ExecutionResponse(
             run_id=row.run_id,
             org_id=row.org_id,
-            asset_id=row.asset_id,
-            asset_key=row.asset_key or "",
+            component_id=row.component_id,
+            component_key=row.component_key or "",
             status=row.status,
             started_at=str(row.started_at) if row.started_at else None,
             completed_at=str(row.completed_at) if row.completed_at else None,