Function aggressive_clean_pio_packages

ci/compiler/package_manager.py:151–207

Aggressively clean PlatformIO packages cache to recover from download failures. This removes all framework and toolchain packages to force re-download. Returns True if any packages were cleaned.

(paths: "FastLEDPaths", board_name: str)

def aggressive_clean_pio_packages(paths: "FastLEDPaths", board_name: str) -> bool:
    """Aggressively clean PlatformIO packages cache to recover from download failures.

    This removes all framework and toolchain packages to force re-download.
    Returns True if any packages were cleaned.
    """
    from ci.util.lock_handler import force_remove_path

    print("\n⚠️  Detected PackageException - Performing aggressive package cleanup...")
    packages_dir = paths.packages_dir

    if not packages_dir.exists():
        print(f"Packages directory doesn't exist: {packages_dir}")
        return False

    cleaned = False

    # List of package patterns that commonly cause issues
    problematic_patterns = [
        "framework-",  # All frameworks
        "tool-",  # All tools
        "esp32-arduino-libs",  # Specific ESP32 libs
        "esptoolpy",  # ESP tool
    ]

    for package_dir in packages_dir.iterdir():
        if not package_dir.is_dir():
            continue

        package_name = package_dir.name

        # Check if matches problematic patterns
        is_problematic = any(
            pattern in package_name.lower() for pattern in problematic_patterns
        )

        if is_problematic:
            print(f"  Removing problematic package: {package_name}")
            try:
                success = force_remove_path(package_dir, max_retries=5)
                if success:
                    print(f"    ✓ Removed {package_name}")
                    cleaned = True
                else:
                    print(f"    ✗ Failed to remove {package_name}")
            except KeyboardInterrupt as ki:
                handle_keyboard_interrupt(ki)
                raise
            except Exception as e:
                print(f"    ✗ Error removing {package_name}: {e}")

    if cleaned:
        print(
            "  ✓ Package cleanup complete - PlatformIO will re-download on next build"
        )

    return cleaned