chore: catch json decoder error from deserializing build command from build facts

Author: Trong Nhan Mai

src/macaron/build_spec_generator/macaron_db_extractor.py

@@ -580,6 +580,11 @@ def extract_generic_build_command_info(
     list[GenericBuildCommandInfo]
         The list of GenericBuildCommandInfo instances that store build command information
         representing by the Build Check Facts.
+
+    Raises
+    ------
+    json.decoder.JSONDecodeError
+        If we failed to decode the JSON-serialized values stored in the Build*Facts instances.
     """
     result = []
     for fact in check_facts:
@@ -615,27 +620,73 @@ def extract_generic_build_command_info(
     return result
 
 
-def lookup_any_build_command(component_id: int, session: Session) -> Sequence[GenericBuildCommandInfo]:
-    """WIP."""
+def lookup_any_build_command(component_id: int, session: Session) -> list[GenericBuildCommandInfo]:
+    """Return a list of ``GenericBuildCommandInfo`` instances from looking up any available build command.
+
+    We will look for available build command from build-related check facts.
+
+    Parameters
+    ----------
+    component_id: int
+        The component id to lookup the build command.
+    session: Session
+        The SQLAlchemy session to the database for the lookup.
+
+    Returns
+    -------
+    list[GenericBuildCommandInfo]
+        This list will be empty if there is no available build command for this component.
+
+    Raises
+    ------
+    QueryMacaronDatabaseError
+        If there is an unexpected error when executing the SQLAlchemy query for looking up the build commands.
+        Raised by "lookup_*_check" functions
+    """
     build_as_code_check_facts = lookup_build_as_code_check(
         component_id=component_id,
         session=session,
     )
     if build_as_code_check_facts:
-        return extract_generic_build_command_info(build_as_code_check_facts)
+        try:
+            return extract_generic_build_command_info(build_as_code_check_facts)
+        except json.decoder.JSONDecodeError as error:
+            logger.debug(
+                "Failed to extract generic build command info for build as code check facts for component id %s. "
+                + "Error %s. Continue",
+                component_id,
+                error,
+            )
 
     build_service_check_facts = lookup_build_service_check(
         component_id=component_id,
         session=session,
     )
     if build_service_check_facts:
-        return extract_generic_build_command_info(build_service_check_facts)
+        try:
+            return extract_generic_build_command_info(build_service_check_facts)
+        except json.decoder.JSONDecodeError as error:
+            logger.debug(
+                "Failed to extract generic build command info for build servoce check facts for component id %s. "
+                + "Error %s. Continue",
+                component_id,
+                error,
+            )
 
     build_script_check_facts = lookup_build_script_check(
         component_id=component_id,
         session=session,
     )
-    return extract_generic_build_command_info(build_script_check_facts)
+    try:
+        return extract_generic_build_command_info(build_script_check_facts)
+    except json.decoder.JSONDecodeError as error:
+        logger.debug(
+            "Failed to extract generic build command info for build as code check facts for component id %s. "
+            + "Error %s. Continue",
+            component_id,
+            error,
+        )
+        return []
 
 
 def lookup_repository(component_id: int, session: Session) -> Repository | None: