Function atomic_write_text

ci/meson/io_utils.py:11–46

Atomically write text to a file using temp file + rename pattern. This ensures the file is never left in a corrupted/partial state if the process crashes mid-write. The rename operation is atomic on POSIX systems and nearly atomic on Windows (uses ReplaceFile API via Path.replace()

(path: Path, content: str, encoding: str = "utf-8")

def atomic_write_text(path: Path, content: str, encoding: str = "utf-8") -> None:
    """
    Atomically write text to a file using temp file + rename pattern.

    This ensures the file is never left in a corrupted/partial state if the
    process crashes mid-write. The rename operation is atomic on POSIX systems
    and nearly atomic on Windows (uses ReplaceFile API via Path.replace()).

    Args:
        path: Path to the file to write
        content: Text content to write
        encoding: Text encoding (default: utf-8)

    Raises:
        OSError/IOError: If the write fails and cleanup cannot complete
    """
    # Ensure parent directory exists
    path.parent.mkdir(parents=True, exist_ok=True)

    # Write to temp file first, then atomic rename
    temp_path = path.with_suffix(path.suffix + ".tmp")
    try:
        with open(temp_path, "w", encoding=encoding) as f:
            f.write(content)
            f.flush()
            # Ensure data is written to disk before rename
            os.fsync(f.fileno())
        # Atomic rename - either completes fully or not at all
        temp_path.replace(path)
    except (OSError, IOError):
        # Clean up temp file on error
        try:
            temp_path.unlink()
        except (OSError, IOError):
            pass
        raise


def write_if_different(path: Path, content: str, mode: Optional[int] = None) -> bool: