Struct toolbox::vfs::VirtualFileSystem

pub struct VirtualFileSystem {
    pub root: PathBuf,
}

A reference to an virtual file system.

Fields

root: PathBuf

Methods

impl VirtualFileSystem

pub fn try_new<P: AsRef<Path>>(root: P) -> Result<Self>

Create new VirtualFileSystem.

root - base directory for VFS. A root path must exists; else return value will be io::Error. It will be normalized.

pub fn absolute<P: AsRef<Path>>(&self, path: P) -> Option<PathBuf>

Convert relative path to absolute.

If path is absolute and starts with current root, then return it, else return None. If path is relative, then append it to the end of the current root and return joined path.

pub fn relative<P: AsRef<Path>>(&self, path: P) -> Option<PathBuf>

Convert absolute path to relative.

If path is relative, then normalize it and return. If path is equal to root, then return . (current). If root equals to /foo/bar and path equals to /foo/bar/more, then return more.

pub fn exists<P: AsRef<Path>>(&self, path: P) -> bool

Returns true if the path points at an existing entity.

pub fn chroot<P: AsRef<Path>>(&mut self, new_root: P) -> bool

Change current root.

A new_root path may be absolute or relative. Return true if root was change.

pub fn create_dir<P: AsRef<Path>>(&self, path: P) -> Result<()>

Creates a new, empty directory at the provided path.

pub fn create_dir_all<P: AsRef<Path>>(&self, path: P) -> Result<()>

Recursively create a directory and all of its parent components if they are missing.

pub fn remove_dir<P: AsRef<Path>>(&self, path: P) -> Result<()>

Removes a directory at this path, after removing all its contents. Use carefully!

pub fn remove_dir_all<P: AsRef<Path>>(&self, path: P) -> Result<()>

Removes a directory at this path, after removing all its contents. Use carefully!

pub fn normalize<P: AsRef<Path>>(path: P) -> PathBuf