gravitino.filesystem.gvfs_default_operations.DefaultGVFSOperations

class gravitino.filesystem.gvfs_default_operations.DefaultGVFSOperations(server_uri: str | None = None, metalake_name: str | None = None, options: Dict | None = None, **kwargs)

Bases: BaseGVFSOperations

Default implementation of the Gravitino Virtual File System operations.

__init__(server_uri: str | None = None, metalake_name: str | None = None, options: Dict | None = None, **kwargs)

Methods

__init__([server_uri, metalake_name, options])

cat_file(path[, start, end])

Get the content of a file.

cp_file(path1, path2, **kwargs)

Copy a file.

created(path)

Return the created timestamp of a file as a datetime.datetime Only supports for fsspec.LocalFileSystem now.

exists(path, **kwargs)

Check if a file or a directory exists.

get_file(rpath, lpath[, callback, outfile])

Copy single remote file to local.

info(path, **kwargs)

Get file info.

ls(path[, detail])

List the files and directories info of the path.

makedirs(path[, exist_ok])

Make a directory recursively.

mkdir(path[, create_parents])

Make a directory.

modified(path)

Returns the modified time of the path file if it exists.

mv(path1, path2[, recursive, maxdepth])

Move a file to another directory.

open(path[, mode, block_size, ...])

Open a file to read/write/append.

rm(path[, recursive, maxdepth])

Remove a file or directory. :param path: Virtual fileset path :param recursive: Whether to remove the directory recursively. When removing a directory, this parameter should be True. :param maxdepth: The maximum depth to remove the directory recursively.

rm_file(path)

Remove a file.

rmdir(path)

Remove a directory.

Attributes

ENABLE_CREDENTIAL_VENDING_DEFAULT

ENV_CURRENT_LOCATION_NAME_ENV_VAR_DEFAULT

SLASH

current_location_name

cat_file(path, start=None, end=None, **kwargs)

Get the content of a file. :param path: Virtual fileset path :param start: The offset in bytes to start reading from. It can be None. :param end: The offset in bytes to end reading at. It can be None. :param kwargs: Extra args :return File content

cp_file(path1, path2, **kwargs)

Copy a file. :param path1: Virtual src fileset path :param path2: Virtual dst fileset path, should be consistent with the src path fileset identifier :param kwargs: Extra args

created(path)

Return the created timestamp of a file as a datetime.datetime Only supports for fsspec.LocalFileSystem now. :param path: Virtual fileset path :return Created time(datetime.datetime)

exists(path, **kwargs)

Check if a file or a directory exists. :param path: Virtual fileset path :param kwargs: Extra args :return If a file or directory exists, it returns True, otherwise False

get_file(rpath, lpath, callback=None, outfile=None, **kwargs)

Copy single remote file to local. :param rpath: Remote file path :param lpath: Local file path :param callback: The callback class :param outfile: The output file path :param kwargs: Extra args

info(path, **kwargs)

Get file info. :param path: Virtual fileset path :param kwargs: Extra args :return A file info dict

ls(path, detail=True, **kwargs)

List the files and directories info of the path. :param path: Virtual fileset path :param detail: Whether to show the details for the files and directories info :param kwargs: Extra args :return If details is true, returns a list of file info dicts, else returns a list of file paths

makedirs(path, exist_ok=True)

Make a directory recursively. :param path: Virtual fileset path :param exist_ok: Continue if a directory already exists

mkdir(path, create_parents=True, **kwargs)

Make a directory. if create_parents=True, this is equivalent to makedirs.

Parameters:
  • path – Virtual fileset path

  • create_parents – Create parent directories if missing when set to True

  • kwargs – Extra args

modified(path)

Returns the modified time of the path file if it exists. :param path: Virtual fileset path :return Modified time(datetime.datetime)

mv(path1, path2, recursive=False, maxdepth=None, **kwargs)
Move a file to another directory.

This can move a file to another existing directory. If the target path directory does not exist, an exception will be thrown.

Parameters:
  • path1 – Virtual src fileset path

  • path2 – Virtual dst fileset path, should be consistent with the src path fileset identifier

  • recursive – Whether to move recursively

  • maxdepth – Maximum depth of recursive move

  • kwargs – Extra args

open(path, mode='rb', block_size=None, cache_options=None, compression=None, **kwargs)

Open a file to read/write/append. :param path: Virtual fileset path :param mode: The mode now supports: rb(read), wb(write), ab(append). See builtin open() :param block_size: Some indication of buffering - this is a value in bytes :param cache_options: Extra arguments to pass through to the cache :param compression: If given, open file using compression codec :param kwargs: Extra args :return A file-like object from the filesystem

rm(path, recursive=False, maxdepth=None)

Remove a file or directory. :param path: Virtual fileset path :param recursive: Whether to remove the directory recursively.

When removing a directory, this parameter should be True.

Parameters:

maxdepth – The maximum depth to remove the directory recursively.

rm_file(path)

Remove a file. :param path: Virtual fileset path

rmdir(path)

Remove a directory. It will delete a directory and all its contents recursively for PyArrow.HadoopFileSystem. And it will throw an exception if delete a directory which is non-empty for LocalFileSystem. :param path: Virtual fileset path