Function main

ci/util/lock_admin.py:192–273

Main entry point.

()

def main() -> int:
    """Main entry point."""
    parser = argparse.ArgumentParser(
        description="Lock administration tool for cache management",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
  # List all locks with status
  uv run python -m ci.util.lock_admin --list

  # Clean only stale locks (safe)
  uv run python -m ci.util.lock_admin --clean-stale

  # Force unlock everything (DANGEROUS!)
  uv run python -m ci.util.lock_admin --force-unlock-all

  # Check specific lock
  uv run python -m ci.util.lock_admin --check "build:libfastled_build"
        """,
    )

    parser.add_argument(
        "--cache-dir",
        type=Path,
        default=Path.home() / ".platformio" / "global_cache",
        help="Cache directory (default: ~/.platformio/global_cache)",
    )

    parser.add_argument(
        "--list",
        action="store_true",
        help="List all locks with their status",
    )

    parser.add_argument(
        "--clean-stale",
        action="store_true",
        help="Remove only stale locks (safe - checks PID)",
    )

    parser.add_argument(
        "--force-unlock-all",
        action="store_true",
        help="Force remove ALL locks (DANGEROUS - no PID check)",
    )

    parser.add_argument(
        "--check",
        type=str,
        metavar="LOCK_NAME",
        help="Check status of specific lock (by name)",
    )

    args = parser.parse_args()

    # Require at least one action
    if not any([args.list, args.clean_stale, args.force_unlock_all, args.check]):
        parser.print_help()