Class ESP32ArtifactManager

ci/compiler/esp32_artifacts.py:310–360

High-level manager coordinating ESP32 artifact operations.

class ESP32ArtifactManager:
    """High-level manager coordinating ESP32 artifact operations."""

    def __init__(self, build_dir: Path, board_name: str):
        self.build_dir = build_dir
        self.board_name = board_name
        self.discovery = ESP32ArtifactDiscovery(build_dir, board_name)

    def copy_qemu_artifacts(self, output_path: str, sketch_name: str) -> bool:
        """Copy all ESP32 QEMU artifacts to output location."""
        # Discover artifacts
        artifacts = self.discovery.discover()
        if not artifacts.required_files_present:
            print(f"❌ Missing required artifacts: {artifacts.missing_files()}")
            return False

        # Read flash configuration
        flash_config = self.discovery.read_flash_config()

        # Warn about QEMU compatibility
        if not flash_config.is_qemu_compatible():
            print(
                f"⚠️  Warning: Flash mode {flash_config.mode.value} may not be QEMU compatible"
            )
            print("   QEMU works best with DIO mode")

        # Determine output directory
        output_dir = self._resolve_output_dir(output_path)

        # Copy artifacts
        copier = ESP32ArtifactCopier(artifacts, flash_config)
        return copier.copy_for_qemu(output_dir, self.board_name)

    def _resolve_output_dir(self, output_path: str) -> Path:
        """Resolve output path to directory, making relative paths absolute."""
        path = Path(output_path)

        # Extract directory from the path
        if output_path.endswith(".bin"):
            dir_path = path.parent
        else:
            dir_path = path

        # If path is relative, resolve it against project root
        if not dir_path.is_absolute():
            # build_dir is like: /fastled/.build/pio/esp32dev
            # Project root is 3 levels up from build_dir
            project_root = self.build_dir.parent.parent.parent
            dir_path = project_root / dir_path

        return dir_path