Function ensure_directory

codewiki/cli/utils/fs.py:13–37

Ensure directory exists, create if necessary. Args: path: Directory path mode: Directory permissions (default: 0o700 - user only) Returns: Path to the directory Raises: FileSystemError: If directory cannot be created

(path: Path, mode: int = 0o700)

def ensure_directory(path: Path, mode: int = 0o700) -> Path:
    """
    Ensure directory exists, create if necessary.

    Args:
        path: Directory path
        mode: Directory permissions (default: 0o700 - user only)

    Returns:
        Path to the directory

    Raises:
        FileSystemError: If directory cannot be created
    """
    try:
        path = Path(path).expanduser().resolve()
        path.mkdir(parents=True, exist_ok=True, mode=mode)
        return path
    except PermissionError:
        raise FileSystemError(
            f"Permission denied: Cannot create directory {path}\nTry: chmod u+w {path.parent}"
        )
    except OSError as e:
        raise FileSystemError(f"Cannot create directory {path}: {e}")


def check_writable(path: Path) -> bool:
    """