Function safe_write

codewiki/cli/utils/fs.py:60–86

Safely write content to a file using atomic write (temp file + rename). Args: path: File path content: Content to write encoding: File encoding Raises: FileSystemError: If write fails

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

def safe_write(path: Path, content: str, encoding: str = "utf-8"):
    """
    Safely write content to a file using atomic write (temp file + rename).
    
    Args:
        path: File path
        content: Content to write
        encoding: File encoding
        
    Raises:
        FileSystemError: If write fails
    """
    path = Path(path).expanduser().resolve()
    temp_path = path.with_suffix(path.suffix + ".tmp")
    
    try:
        # Write to temp file
        with open(temp_path, "w", encoding=encoding) as f:
            f.write(content)
        
        # Atomic rename
        temp_path.replace(path)
    except Exception as e:
        # Clean up temp file if it exists
        if temp_path.exists():
            temp_path.unlink()
        raise FileSystemError(f"Cannot write to {path}: {e}")


def safe_read(path: Path, encoding: str = "utf-8") -> str: