Function run_compile

ci/debug_attached.py:167–247

Compile the PlatformIO project. On Windows Git Bash: Runs via cmd.exe with clean environment (no Git Bash indicators) On other platforms: Runs directly with UTF-8 environment Args: build_dir: Project directory containing platformio.ini environment: PlatformIO environmen

(
    build_dir: Path,
    environment: str | None = None,
    verbose: bool = False,
    clean: bool = False,
)

def run_compile(
    build_dir: Path,
    environment: str | None = None,
    verbose: bool = False,
    clean: bool = False,
) -> bool:
    """Compile the PlatformIO project.

    On Windows Git Bash: Runs via cmd.exe with clean environment (no Git Bash indicators)
    On other platforms: Runs directly with UTF-8 environment

    Args:
        build_dir: Project directory containing platformio.ini
        environment: PlatformIO environment to build (None = default)
        verbose: Enable verbose output
        clean: Clean build artifacts before compiling

    Returns:
        True if compilation succeeded, False otherwise
    """
    if clean:
        clean_cmd = ["pio", "run", "--target", "clean", "--project-dir", str(build_dir)]
        if environment:
            clean_cmd.extend(["--environment", environment])
        print("🧹 Cleaning build artifacts...")
        subprocess.run(clean_cmd, capture_output=True)

    cmd = ["pio", "run", "--project-dir", str(build_dir)]
    if environment:
        cmd.extend(["--environment", environment])
    if verbose:
        cmd.append("--verbose")

    print("=" * 60)
    print("COMPILING")
    print("=" * 60)

    # Log which sketch is being compiled (from PLATFORMIO_SRC_DIR env var)
    src_dir = os.environ.get("PLATFORMIO_SRC_DIR")
    if src_dir:
        # Convert to relative path for cleaner output
        try:
            rel_path = Path(src_dir).relative_to(build_dir)
            print(f"📁 Source: {rel_path}")
        except ValueError:
            # Not relative to build_dir, show absolute path
            print(f"📁 Source: {src_dir}")
    else:
        print("📁 Source: (using platformio.ini default)")
    print()

    formatter = TimestampFormatter()
    # Use create_pio_process() for Git Bash compatibility
    proc = create_pio_process(
        cmd,
        cwd=build_dir,
        output_formatter=formatter,
        auto_run=True,