Function main

ci/meson/src_metadata_cache.py:142–233

Main entry point for source metadata cache operations.

(argv: list[str] | None = None)

def main(argv: list[str] | None = None) -> None:
    """Main entry point for source metadata cache operations."""
    parser = argparse.ArgumentParser(
        description="Manage source metadata cache for Meson build system"
    )

    # Mutually exclusive operation modes
    group = parser.add_mutually_exclusive_group(required=True)
    group.add_argument(
        "--check",
        action="store_true",
        help="Check if cache is valid (exit 0 if valid, 1 if invalid)",
    )
    group.add_argument(
        "--update", action="store_true", help="Update cache with new metadata"
    )
    group.add_argument(
        "--invalidate", action="store_true", help="Force invalidate cache"
    )

    # Positional arguments
    parser.add_argument(
        "src_dir",
        nargs="?",
        type=Path,
        help="Source directory (required for --check, --update)",
    )
    parser.add_argument(
        "build_dir",
        nargs="?",
        type=Path,
        help="Build directory (required for all operations)",
    )
    parser.add_argument(
        "metadata", nargs="?", type=str, help="Source metadata (required for --update)"
    )
    parser.add_argument(
        "--pattern",
        type=str,
        default="*.cpp",
        help="File pattern to match (default: *.cpp)",
    )

    args = parser.parse_args(argv)

    # Validate arguments based on operation
    if args.invalidate:
        if not args.build_dir:
            print("Error: --invalidate requires <build_dir>", file=sys.stderr)
            sys.exit(1)

        cache_file = args.build_dir / CACHE_FILENAME
        if cache_file.exists():
            cache_file.unlink()
        sys.exit(0)

    elif args.check:
        if not args.src_dir or not args.build_dir: