build: add directory-oriented make workflows

firmware/scripts/summarize-test-coverage.py

@@ -34,7 +34,9 @@ class CoverageFormatError(ValueError):
     """Coverage records cannot be safely summarized by source location."""
 
 
-def selected_files(report: dict[object, object], source_path: str) -> Iterable[dict[object, object]]:
+def selected_files(
+    report: dict[object, object], source_path: str
+) -> Iterable[dict[object, object]]:
     """Yield selected file records after rejecting ambiguous macro expansion."""
     exports = report.get("data")
     if not isinstance(exports, list):
@@ -78,7 +80,11 @@ def lcov_line_totals(report: str, source_path: str) -> tuple[int, int, set[str]]
         if record == "end_of_record":
             filename = None
             continue
-        if filename is None or source_path not in filename or not record.startswith("DA:"):
+        if (
+            filename is None
+            or source_path not in filename
+            or not record.startswith("DA:")
+        ):
             continue
         fields = record[3:].split(",", 2)
         if len(fields) < 2:
@@ -87,7 +93,9 @@ def lcov_line_totals(report: str, source_path: str) -> tuple[int, int, set[str]]
             line = int(fields[0])
             count = int(fields[1])
         except ValueError as error:
-            raise CoverageFormatError(f"{filename}: non-integer LCOV DA record") from error
+            raise CoverageFormatError(
+                f"{filename}: non-integer LCOV DA record"
+            ) from error
         if line <= 0 or count < 0:
             raise CoverageFormatError(f"{filename}: invalid LCOV DA location or count")
         key = (filename, line)
@@ -100,7 +108,9 @@ def lcov_line_totals(report: str, source_path: str) -> tuple[int, int, set[str]]
     return sum(lines.values()), len(lines), files
 
 
-def branch_totals(report: dict[object, object], source_path: str) -> tuple[int, int, set[str]]:
+def branch_totals(
+    report: dict[object, object], source_path: str
+) -> tuple[int, int, set[str]]:
     """Return the union of selected JSON branch outcomes and source files."""
     branches: dict[tuple[str, int, int, int, int], list[bool]] = {}
     files: set[str] = set()
@@ -142,7 +152,9 @@ def branch_totals(report: dict[object, object], source_path: str) -> tuple[int,
                 or file_id < 0
                 or expanded_file_id < 0
             ):
-                raise CoverageFormatError(f"{filename}: invalid branch location or count")
+                raise CoverageFormatError(
+                    f"{filename}: invalid branch location or count"
+                )
             if file_id != expanded_file_id:
                 raise CoverageFormatError(
                     f"{filename}:{start_line}:{start_column}: macro-expanded branch is present; "
@@ -175,9 +187,15 @@ def coverage_totals(
 
 def main() -> int:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("lcov_report", type=Path, help="LCOV report from cargo llvm-cov")
-    parser.add_argument("json_report", type=Path, help="LLVM JSON report from cargo llvm-cov")
-    parser.add_argument("source_path", help="workspace-relative path fragment to include")
+    parser.add_argument(
+        "lcov_report", type=Path, help="LCOV report from cargo llvm-cov"
+    )
+    parser.add_argument(
+        "json_report", type=Path, help="LLVM JSON report from cargo llvm-cov"
+    )
+    parser.add_argument(
+        "source_path", help="workspace-relative path fragment to include"
+    )
     arguments = parser.parse_args()
 
     try: