Function scan_sketch_assets

ci/compiler/asset_scanner.py:136–189

Scan `` /data/`` for ``*.lnk`` asset links. Only the ``data/`` subdirectory is walked. Files whose names do NOT end in ``.lnk`` are ignored — they ship as-is as normal assets and don't need a manifest entry. Args: sketch_dir: Path to the sketch directory (the one

(sketch_dir: Path)

def scan_sketch_assets(sketch_dir: Path) -> AssetScanResult:
    """Scan ``<sketch_dir>/data/`` for ``*.lnk`` asset links.

    Only the ``data/`` subdirectory is walked. Files whose names do NOT end in
    ``.lnk`` are ignored — they ship as-is as normal assets and don&#x27;t need a
    manifest entry.

    Args:
        sketch_dir: Path to the sketch directory (the one containing the
            ``.ino`` / ``.cpp`` file).

    Returns:
        :class:`AssetScanResult` with the manifest plus any warnings.
    """
    result = AssetScanResult()
    data_dir = sketch_dir / "data"
    if not data_dir.is_dir():
        return result

    for lnk_path in sorted(data_dir.rglob("*.lnk")):
        if not lnk_path.is_file():
            continue

        # Relative asset path, with the ``.lnk`` suffix stripped so the key
        # matches the name the sketch will write (e.g. ``"data/track.mp3"``).
        rel_with_lnk = lnk_path.relative_to(sketch_dir).as_posix()
        if not rel_with_lnk.endswith(".lnk"):
            # Defensive — rglob should never hand us one of these, but be safe.
            continue
        rel_without_lnk = rel_with_lnk[: -len(".lnk")]

        try:
            content = lnk_path.read_text(encoding="utf-8")
        except UnicodeDecodeError as exc:
            result.warnings.append(
                f"asset-scan: {lnk_path}: not valid UTF-8 ({exc}); skipped"
            )
            continue
        except OSError as exc:
            result.warnings.append(
                f"asset-scan: {lnk_path}: read failed ({exc}); skipped"
            )
            continue

        entry = _parse_lnk_content(content)
        if entry is None:
            result.warnings.append(
                f"asset-scan: {lnk_path}: no URL found in .lnk; skipped"
            )
            continue

        result.manifest[rel_without_lnk] = entry

    return result


def write_manifest_json(scan: AssetScanResult, out_path: Path) -> None: