interloper-api 0.84.0__tar.gz → 0.86.0__tar.gz

{interloper_api-0.84.0 → interloper_api-0.86.0}/PKG-INFO

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

{interloper_api-0.84.0 → interloper_api-0.86.0}/pyproject.toml

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

{interloper_api-0.84.0 → interloper_api-0.86.0}/pyproject.toml.orig

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

{interloper_api-0.84.0 → interloper_api-0.86.0}/src/interloper_api/routes/runs.py

@@ -10,7 +10,7 @@ from fastapi import APIRouter, HTTPException, Query, Response
 from interloper.errors import NotFoundError
 from interloper_db import Profile, Store
 from interloper_db.models import Event, Execution, Run
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 from interloper_api.dependencies import (
     CurrentUserDep,
@@ -40,6 +40,15 @@ class RunResponse(BaseModel):
     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).
+
+    A response is one attempt. In a stack-native listing it is the stack's
+    latest, so ``attempt`` is also how many attempts the stack took; fetching
+    an older attempt by id gives that attempt's own number. ``root_run_id``
+    is what groups them, and lists them through ``?root_run_id=``.
+
+    ``execution_counts`` is the attempt's own operation executions per status
+    (a failed-scope retry only re-executes what had not succeeded), so a
+    listing can draw each attempt's progress without fetching its executions.
     """
 
     id: UUID
@@ -52,18 +61,23 @@ class RunResponse(BaseModel):
     partition_key: str | None
     status: str
     retry_of: UUID | None = None
+    root_run_id: UUID | None = None
     attempt: int = 1
     retry_scope: str | None = None
+    scheduled_for: str | None = None
     started_at: str | None = None
     completed_at: str | None = None
     created_at: str | None = None
+    execution_counts: dict[str, int] = Field(default_factory=dict)
 
     @classmethod
-    def from_run(cls, run: Run) -> RunResponse:
+    def from_run(cls, run: Run, execution_counts: dict[str, int] | None = None) -> RunResponse:
         """Convert a DB Run to a RunResponse.
 
         Args:
             run: The DB Run row, with its ``target`` relationship loaded.
+            execution_counts: The run's execution count per status; None (a
+                run just queued) reads as no executions yet.
 
         Returns:
             The response model.
@@ -79,11 +93,14 @@ class RunResponse(BaseModel):
             partition_key=run.partition_key,
             status=run.status,
             retry_of=run.retry_of,
+            root_run_id=run.root_run_id,
             attempt=run.attempt,
             retry_scope=run.retry_scope,
+            scheduled_for=str(run.scheduled_for) if run.scheduled_for else None,
             started_at=str(run.started_at) if run.started_at else None,
             completed_at=str(run.completed_at) if run.completed_at else None,
             created_at=str(run.created_at) if run.created_at else None,
+            execution_counts=execution_counts or {},
         )
 
 
@@ -222,10 +239,16 @@ def list_runs(
     q: str | None = None,
     component_kind: str | None = None,
     component_key: str | None = None,
+    root_run_id: UUID | None = None,
     limit: int = 50,
     offset: int = 0,
 ) -> list[RunResponse]:
-    """List runs with optional filters.
+    """List one row per run stack, or one stack's attempts.
+
+    A stack is one piece of work, so a listing carries its latest attempt and
+    every filter reads that attempt: a stack whose first attempt failed and
+    whose second succeeded is a success. Passing ``root_run_id`` asks for one
+    stack's attempts instead, newest first.
 
     ``after``/``before`` bound the runs to those whose execution overlaps that
     window — a run occupies ``started_at`` → ``completed_at`` (open-ended while
@@ -247,6 +270,7 @@ def list_runs(
         component_kind: Keep only runs targeting a component of this kind; None applies no filter.
         component_key: Keep only runs targeting a component of this type (catalog key); None
             applies no filter.
+        root_run_id: List this stack's attempts rather than one row per stack.
         limit: Maximum number of runs on the page.
         offset: Number of matching runs to skip before the page starts.
         user: The authenticated user, required to hold at least the ``viewer`` role.
@@ -266,6 +290,7 @@ def list_runs(
         q=q,
         component_kind=component_kind,
         component_key=component_key,
+        root_run_id=root_run_id,
     )
     response.headers["X-Total-Count"] = str(total)
     runs = store.runs.list_all(
@@ -278,10 +303,12 @@ def list_runs(
         q=q,
         component_kind=component_kind,
         component_key=component_key,
+        root_run_id=root_run_id,
         limit=limit,
         offset=offset,
     )
-    return [RunResponse.from_run(r) for r in runs]
+    counts = store.events.count_executions([run.id for run in runs])
+    return [RunResponse.from_run(run, counts.get(run.id)) for run in runs]
 
 
 @router.post("/", status_code=201)
@@ -348,7 +375,7 @@ def get_run(
         The run, as a response model.
     """
     run = _load_authorized_run(run_id, user, store)
-    return RunResponse.from_run(run)
+    return RunResponse.from_run(run, store.events.count_executions([run_id]).get(run_id))
 
 
 @router.get("/{run_id}/executions")