Class DockerAVR8jsRunner

ci/docker_utils/avr8js_docker.py:21–255

Run AVR firmware in avr8js Docker container

class DockerAVR8jsRunner:
    """Run AVR firmware in avr8js Docker container"""

    def __init__(
        self,
        docker_image: str = "niteris/fastled-avr8js:latest",
    ):
        self.docker_image = docker_image

    def _convert_to_docker_volume_path(self, path: Path) -> str:
        """
        Convert Windows path to Docker-compatible volume mount path.

        Windows: C:\\Users\\... -> /c/Users/...
        Unix: /home/... -> /home/...
        """
        if platform.system() == "Windows":
            # Convert Windows path to MSYS2/Docker format
            # C:\Users\... -> /c/Users/...
            path_str = str(path).replace("\\", "/")
            if len(path_str) >= 2 and path_str[1] == ":":
                drive = path_str[0].lower()
                rest = path_str[2:]
                return f"/{drive}{rest}"
            return path_str
        else:
            return str(path)

    def check_docker_available(self) -> bool:
        """Check if Docker is available and running"""
        try:
            result = RunningProcess.run(
                ["docker", "version"], cwd=None, check=False, timeout=5
            )
            return result.returncode == 0
        except (RuntimeError, FileNotFoundError):
            return False

    def check_image_exists(self, image_name: str) -> bool:
        """Check if Docker image exists locally"""
        try:
            result = RunningProcess.run(
                ["docker", "images", "-q", image_name],
                check=False,
                timeout=10,
                capture_output=True,
                text=True,
            )
            return bool(result.stdout.strip())
        except (RuntimeError, FileNotFoundError):
            return False

    def pull_image(self) -> None:
        """Pull Docker image from registry"""
        subprocess.run(["docker", "pull", self.docker_image], check=True)

    def run(
        self,