Class AssetScanResult

ci/compiler/asset_scanner.py:61–78

Result of scanning a sketch's ``data/`` directory. Attributes: manifest: Dict mapping relative asset paths (POSIX form, e.g. ``"data/track.mp3"``) to ``AssetEntry``. Missing ``data/`` or an empty one yields an empty dict — not an error. warnings: Non-fata

@dataclass
class AssetScanResult:
    """Result of scanning a sketch's ``data/`` directory.

    Attributes:
        manifest: Dict mapping relative asset paths (POSIX form, e.g.
            ``"data/track.mp3"``) to ``AssetEntry``. Missing ``data/`` or an
            empty one yields an empty dict — not an error.
        warnings: Non-fatal issues encountered during scanning (malformed
            ``.lnk`` files, unreadable files, etc.). Callers should log them
            but the build should NOT fail on these.
    """

    manifest: dict[str, AssetEntry] = field(default_factory=dict)
    warnings: list[str] = field(default_factory=list)

    def to_json_dict(self) -> dict[str, dict[str, str | None]]:
        """Return manifest as a plain nested dict for JSON serialization."""
        return {key: asdict(entry) for key, entry in self.manifest.items()}


# -----------------------------------------------------------------------------