Function scan_single_file

ci/ci-iwyu.py:153–229

Scan a single C++ file for IWYU violations. Args: file_path: Path to the file to scan. Returns: (rel_path, removals) — empty rel_path if no violations.

(file_path: str)

def scan_single_file(file_path: str) -> tuple[str, list[str]]:
    """Scan a single C++ file for IWYU violations.

    Args:
        file_path: Path to the file to scan.

    Returns:
        (rel_path, removals) — empty rel_path if no violations.
    """
    f = Path(file_path).resolve()
    project_root = _PROJECT_ROOT

    is_header = f.suffix in (".h", ".hpp", ".hh", ".hxx")
    is_test = False
    try:
        f.relative_to(project_root / "tests")
        is_test = True
    except ValueError:
        pass

    compiler_args = [
        "clang-tool-chain-cpp",
        "-std=gnu++11",
        "-DSTUB_PLATFORM",
        "-DARDUINO=10808",
        "-DFASTLED_USE_STUB_ARDUINO",
        "-DFASTLED_STUB_IMPL",
        "-DFASTLED_TESTING",
        "-DFASTLED_UNIT_TEST=1",
        f"-I{project_root / 'src'}",
        f"-I{project_root / 'src' / 'platforms' / 'stub'}",
    ]
    if is_test:
        compiler_args.append(f"-I{project_root / 'tests'}")
    if is_header:
        compiler_args.extend(["-x", "c++-header"])
    compiler_args.extend(["-c", str(f)])

    iwyu_cmd = [
        sys.executable,
        str(project_root / "ci" / "iwyu_wrapper.py"),
        "-Xiwyu",
        "--error",
        "--",
    ] + compiler_args

    try:
        result = subprocess.run(iwyu_cmd, capture_output=True, text=True, timeout=60)
    except subprocess.TimeoutExpired:
        return ("", [])

    if result.returncode == 0:
        return ("", [])

    removals: list[str] = []
    in_remove = False
    for line in result.stderr.split("\n"):
        if "should remove" in line: