Function main

ci/lint/clang_tidy/noexcept_platforms.py:318–378

()

def main() -> int:
    import argparse

    parser = argparse.ArgumentParser(
        description=(
            "Clang-tidy rule: enforce FL_NOEXCEPT on platform functions. "
            "Uses clang-query AST analysis for zero false positives."
        )
    )
    parser.add_argument(
        "--fix",
        action="store_true",
        help="Auto-fix: insert FL_NOEXCEPT into source files (default: check only)",
    )
    args = parser.parse_args()

    clang_query = _find_clang_query()
    if not clang_query:
        print("ERROR: clang-query not found.")
        print("Install LLVM: https://github.com/llvm/llvm-project/releases")
        return 1

    print(f"Using: {clang_query}")
    print(f"Scope: src/platforms/")
    print(f"Mode:  {'fix' if args.fix else 'check'}")
    print()

    # AST analysis
    print("Running clang-query (AST analysis)...")
    hits = _find_missing_noexcept(clang_query)

    if not hits:
        print("\nAll functions have FL_NOEXCEPT. Nothing to do.")
        return 0

    # Group by file for display
    by_file: dict[str, list[tuple[int, str]]] = {}
    for filepath, line_num, line_text in hits:
        by_file.setdefault(filepath, []).append((line_num, line_text))

    print(
        f"\nFound {len(hits)} functions missing FL_NOEXCEPT in {len(by_file)} files:\n"
    )

    if args.fix:
        changes, files = _apply_fixes(hits, dry_run=False)
        print(f"\nApplied {changes} changes across {files} files.")
        return 0
    else:
        # Check-only mode: print violations and exit with error
        for filepath in sorted(by_file):
            print(f"{filepath}:")
            for line_num, line_text in sorted(by_file[filepath]):
                print(f"  Line {line_num}: {line_text}")
            print()

        # Also show what --fix would do
        print("--- Dry-run preview (use --fix to apply) ---\n")