Function copy_boards_directory

ci/compiler/source_manager.py:296–342

Copy boards directory to the build directory.

(project_root: Path, build_dir: Path)

def copy_boards_directory(project_root: Path, build_dir: Path) -> bool:
    """Copy boards directory to the build directory."""
    boards_src = project_root / "ci" / "boards"
    boards_dst = build_dir / "boards"

    if not boards_src.exists():
        warnings.warn(f"Boards directory not found: {boards_src}")
        return False

    try:
        # Ensure target directory exists for dirsync
        boards_dst.mkdir(parents=True, exist_ok=True)

        # Use sync for better caching - purge=True removes extra files
        # Only pass content=True in Docker environments (content-based comparison)
        # On other systems, use default behavior (timestamp/size) by omitting the parameter
        # On Windows, add retry logic for file locking issues
        max_retries = 3 if sys.platform == "win32" else 1
        retry_delay = 0.5  # seconds

        for attempt in range(max_retries):
            try:
                _is_docker = os.environ.get("DOCKER_CONTAINER", "") != ""
                _scandir_sync(
                    str(boards_src),
                    str(boards_dst),
                    purge=True,
                    content=_is_docker,
                )
                break  # Success, exit retry loop
            except OSError as e:
                # Handle Windows file locking errors (WinError 32)
                if sys.platform == "win32" and attempt < max_retries - 1:
                    print(
                        f"File access error during boards sync, retrying ({attempt + 1}/{max_retries}): {e}"
                    )
                    time.sleep(retry_delay)
                else:
                    raise
    except KeyboardInterrupt as ki:
        handle_keyboard_interrupt(ki)
        raise
    except Exception as e:
        warnings.warn(f"Failed to sync boards directory: {e}")
        return False

    return True


def copy_fastled_library(project_root: Path, build_dir: Path) -> bool: