add paginated listing of program release history

Author: bisgaard-itis

services/api-server/src/simcore_service_api_server/_service_programs.py

@@ -53,3 +53,38 @@ async def list_latest_programs(
 
         items = [Program.create_from_service(service) for service in page]
         return items, page_meta
+
+    async def list_program_history(
+        self,
+        *,
+        user_id: int,
+        program_key: ProgramKeyId,
+        product_name: str,
+        offset: NonNegativeInt,
+        limit: PositiveInt,
+    ) -> tuple[list[Program], PageMetaInfoLimitOffset]:
+        page, page_meta = await self._catalog_service.list_release_history(
+            user_id=user_id,
+            service_key=program_key,
+            product_name=product_name,
+            offset=offset,
+            limit=limit,
+        )
+
+        program_instance = await self._catalog_service.get(
+            user_id=user_id,
+            name=program_key,
+            version=page[-1].version,
+            product_name=product_name,
+        )
+
+        items = [
+            Program.create_from_service_release(
+                service=service,
+                service_key=program_instance.key,
+                description=program_instance.description,
+                name=program_instance.name,
+            )
+            for service in page
+        ]
+        return items, page_meta

services/api-server/src/simcore_service_api_server/api/routes/programs.py

@@ -63,6 +63,41 @@ async def list_programs(
     )
 
 
+@router.get(
+    "/{program_key:path}/releases",
+    response_model=Page[Program],
+)
+async def list_program_history(
+    program_key: ProgramKeyId,
+    user_id: Annotated[PositiveInt, Depends(get_current_user_id)],
+    program_service: Annotated[ProgramService, Depends()],
+    url_for: Annotated[Callable, Depends(get_reverse_url_mapper)],
+    product_name: Annotated[str, Depends(get_product_name)],
+    page_params: Annotated[PaginationParams, Depends()],
+) -> Page[Program]:
+    """Lists the latest of all available programs"""
+    programs, page_meta = await program_service.list_program_history(
+        program_key=program_key,
+        user_id=user_id,
+        product_name=product_name,
+        offset=page_params.offset,
+        limit=page_params.limit,
+    )
+    page_params.limit = page_meta.limit
+    page_params.offset = page_meta.offset
+
+    for program in programs:
+        program.url = url_for(
+            "get_program_release", program_key=program.id, version=program.version
+        )
+
+    return create_page(
+        programs,
+        total=len(programs),
+        params=page_params,
+    )
+
+
 @router.get(
     "/{program_key:path}/releases/{version}",
     response_model=Program,

services/api-server/tests/unit/test_api_programs.py

@@ -115,11 +115,24 @@ def _side_effect(
     job = Job.model_validate(response.json())
 
 
-async def test_list_programs(
+async def test_list_latest_programs(
     auth: httpx.BasicAuth,
     client: AsyncClient,
     mocked_catalog_rpc_api: dict[str, MockType],
 ):
     # Arrange
     response = await client.get(f"/{API_VTAG}/programs", auth=auth)
     assert response.status_code == status.HTTP_200_OK
+
+
+async def test_list_program_history(
+    auth: httpx.BasicAuth,
+    client: AsyncClient,
+    mocked_catalog_rpc_api: dict[str, MockType],
+):
+    program_key = "simcore/services/dynamic/my_program"
+    # Arrange
+    response = await client.get(
+        f"/{API_VTAG}/programs/{program_key}/releases", auth=auth
+    )
+    assert response.status_code == status.HTTP_200_OK