web: extend api to list standard build files from firmware server

Author: shiv-tyagi

web/api/v1/vehicles.py

@@ -5,9 +5,11 @@
     VehicleBase,
     VersionOut,
     BoardOut,
+    StandardArtifactOut,
     FeatureOut,
 )
 from web.services.vehicles import get_vehicles_service, VehiclesService
+from metadata_manager.ap_src_meta_fetcher import FirmwareServerUnavailableError
 
 router = APIRouter(prefix="/vehicles", tags=["vehicles"])
 
@@ -183,6 +185,55 @@ async def get_board(
     return board
 
 
+@router.get(
+    "/{vehicle_id}/versions/{version_id}/boards/{board_id}/standard_artifacts",
+    response_model=List[StandardArtifactOut],
+    responses={
+        404: {"description": "Standard artifacts not found"},
+        502: {"description": "Firmware server unavailable"},
+    }
+)
+async def list_board_standard_artifacts(
+    vehicle_id: str = Path(..., description="Vehicle identifier"),
+    version_id: str = Path(..., description="Version identifier"),
+    board_id: str = Path(..., description="Board identifier"),
+    service: VehiclesService = Depends(get_vehicles_service)
+):
+    """
+    Get standard build artifact files from firmware.ardupilot.org for a board.
+
+    Args:
+        vehicle_id: The vehicle identifier
+        version_id: The version identifier
+        board_id: The board identifier
+
+    Returns:
+        List of artifact files with download URLs
+    """
+    try:
+        artifacts = service.get_board_standard_artifacts(
+            vehicle_id, version_id, board_id
+        )
+    except FirmwareServerUnavailableError:
+        raise HTTPException(
+            status_code=502,
+            detail=(
+                "Failed to fetch standard artifacts from firmware server"
+            )
+        )
+
+    if artifacts is None:
+        raise HTTPException(
+            status_code=404,
+            detail=(
+                f"Standard artifacts not found for board '{board_id}' "
+                f"in vehicle '{vehicle_id}' version '{version_id}'"
+            )
+        )
+
+    return artifacts
+
+
 # --- Feature Endpoints ---
 @router.get(
     "/{vehicle_id}/versions/{version_id}/boards/{board_id}/features",

web/requirements.txt

@@ -3,6 +3,7 @@ uvicorn==0.40.0
 pydantic==2.5.0
 redis==5.2.1
 requests==2.31.0
+beautifulsoup4==4.12.3
 jsonschema==4.20.0
 dill==0.3.8
 packaging==25.0

web/schemas/__init__.py

@@ -27,6 +27,7 @@
     VersionOut,
     BoardBase,
     BoardOut,
+    StandardArtifactOut,
     CategoryBase,
     FeatureDefault,
     FeatureBase,
@@ -49,6 +50,7 @@
     "VersionOut",
     "BoardBase",
     "BoardOut",
+    "StandardArtifactOut",
     "CategoryBase",
     "FeatureDefault",
     "FeatureBase",

web/schemas/vehicles.py

@@ -1,4 +1,5 @@
 # app/schemas/vehicles.py
+from datetime import datetime
 from typing import Literal, Optional
 
 from pydantic import BaseModel, Field
@@ -49,6 +50,15 @@ class BoardOut(BoardBase):
     version_id: str = Field(..., description="Associated version identifier")
 
 
+class StandardArtifactOut(BaseModel):
+    name: str = Field(..., description="Artifact filename")
+    url: str = Field(..., description="Download URL on firmware.ardupilot.org")
+    size: Optional[int] = Field(None, description="File size in bytes")
+    modified: Optional[datetime] = Field(
+        None, description="Last modified time (UTC, ISO 8601)"
+    )
+
+
 # --- Features ---
 class CategoryBase(BaseModel):
     id: str = Field(..., description="Unique category identifier")

web/services/vehicles.py

@@ -10,6 +10,7 @@
     RemoteInfo,
     VersionOut,
     BoardOut,
+    StandardArtifactOut,
     FeatureOut,
     CategoryBase,
     FeatureDefault,
@@ -150,6 +151,52 @@ def get_board(
                 return board
         return None
 
+    def get_board_standard_artifacts(
+        self,
+        vehicle_id: str,
+        version_id: str,
+        board_id: str,
+    ) -> Optional[List[StandardArtifactOut]]:
+        """Get standard build artifacts from firmware.ardupilot.org for a board."""
+        version_info = self.versions_fetcher.get_version_info(
+            vehicle_id=vehicle_id,
+            version_id=version_id,
+        )
+        if not version_info:
+            return None
+
+        if not self.get_board(vehicle_id, version_id, board_id):
+            return None
+
+        if version_info.ap_build_artifacts_url is None:
+            return None
+
+        logger.info(
+            f'Standard artifacts requested for {vehicle_id} '
+            f'{version_info.remote_info.name} {version_info.commit_ref} '
+            f'board {board_id}'
+        )
+
+        artifacts = (
+            self.ap_src_metadata_fetcher.get_board_standard_artifacts_from_fw_server(
+                version_artifacts_url=version_info.ap_build_artifacts_url,
+                board_id=board_id,
+                vehicle_id=vehicle_id,
+            )
+        )
+        if artifacts is None:
+            return None
+
+        return [
+            StandardArtifactOut(
+                name=entry["name"],
+                url=entry["url"],
+                size=entry.get("size"),
+                modified=entry.get("modified"),
+            )
+            for entry in artifacts
+        ]
+
     def get_features(
         self,
         vehicle_id: str,