Function main

ci/util/toolchain_downloader.py:296–368

Main entry point for command-line usage.

()

def main() -> int:
    """Main entry point for command-line usage."""
    import argparse

    parser = argparse.ArgumentParser(
        description="Pre-download toolchains from platformio.ini"
    )
    parser.add_argument(
        "platformio_ini",
        type=Path,
        help="Path to platformio.ini file",
    )
    parser.add_argument(
        "--cache-dir",
        type=Path,
        default=None,
        help="Cache directory (default: ~/.platformio/global_cache)",
    )
    parser.add_argument(
        "--max-workers",
        type=int,
        default=4,
        help="Maximum number of concurrent downloads (default: 4)",
    )
    parser.add_argument(
        "--force-unlock",
        action="store_true",
        help="Break all locks before starting (recovery from crashes)",
    )

    args = parser.parse_args()

    if not args.platformio_ini.exists():
        logger.error(f"platformio.ini not found: {args.platformio_ini}")
        return 1

    # Get cache directory
    cache_dir = (
        args.cache_dir
        if args.cache_dir
        else Path.home() / ".platformio" / "global_cache"
    )

    # Handle force unlock if requested
    if args.force_unlock:
        logger.info("🔓 Breaking all locks in cache directory...")
        broken = force_unlock_cache(cache_dir)
        if broken > 0:
            logger.info(f"   Broke {broken} lock(s)")
        else:
            logger.info("   No locks found")

    try:
        results = predownload_toolchains(
            args.platformio_ini,
            cache_dir=cache_dir,
            max_workers=args.max_workers,
        )