Function add_include

ci/fix_has_include.py:162–206

Add the include to the file. Returns True if file was modified (or would be modified in dry-run).

(file_path: Path, include_path: str, dry_run: bool = True)

def add_include(file_path: Path, include_path: str, dry_run: bool = True) -> bool:
    """
    Add the include to the file.

    Returns True if file was modified (or would be modified in dry-run).
    """
    try:
        content = file_path.read_text(encoding="utf-8", errors="ignore")

        # Find insertion point
        line_num, indent = find_insertion_point(content)

        # Build the include line
        include_line = f'{indent}#include "{include_path}"  // IWYU pragma: keep\n'

        # Insert the include
        lines = content.splitlines(keepends=True)

        # If inserting at line_num, we want to add BEFORE that line
        # But we want to add after header guard and before other includes
        # So we need to add a blank line after the include if there isn't one

        if line_num < len(lines):
            # Insert before line_num
            new_lines = lines[:line_num] + [include_line, "\n"] + lines[line_num:]
        else:
            # Append at end
            new_lines = lines + ["\n", include_line, "\n"]

        new_content = "".join(new_lines)

        if dry_run:
            print(f"  Would add include at line {line_num + 1}")
            return True
        else:
            file_path.write_text(new_content, encoding="utf-8")
            print(f"  ✓ Added include at line {line_num + 1}")
            return True

    except KeyboardInterrupt:
        _thread.interrupt_main()
        raise
    except Exception as e:
        print(f"  ✗ Error modifying file: {e}", file=sys.stderr)
        return False


def main():