Struct StdVfs 

pub struct StdVfs;

Standard-library-backed production filesystem.

Trait Implementations

impl Clone for StdVfs

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for StdVfs

impl Debug for StdVfs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StdVfs

fn default() -> Self

Returns the “default value” for a type.

impl Vfs for StdVfs

fn truncate(&self, path: &Path, length: u64) -> Result<()>

Removes a suffix without copying the retained file bytes.

fn create_new(&self, path: &Path, bytes: &[u8]) -> Result<()>

Exclusively creates a file and writes every byte without replacing any existing path. A failed write may leave a new partial file; callers must retain it as an uncommitted artifact until safe cleanup is established. Filesystems without atomic exclusive creation fail explicitly.

fn ensure_directory(&self, path: &Path, create: bool) -> Result<bool>

Admits a store directory, creating missing ancestors when requested, and reports whether the resulting path is a directory.

fn create_directory(&self, path: &Path) -> Result<()>

Exclusively creates one directory. Existing paths are preserved and reported as AlreadyExists; no ancestor is adopted implicitly.

fn remove_directory(&self, path: &Path) -> Result<()>

Removes one empty directory. A non-empty directory is an error.

fn open(&self, path: &Path) -> Result<u64>

Opens an existing path and returns its byte length.

fn open_for_map(&self, path: &Path) -> Result<File>

Opens an existing path as an owned file suitable for memory mapping.

fn read(&self, path: &Path) -> Result<Vec<u8>>

Reads an entire file.

fn read_range(&self, path: &Path, offset: u64, length: usize) -> Result<Vec<u8>>

Reads at most length bytes beginning at offset.

fn write(&self, path: &Path, bytes: &[u8]) -> Result<()>

Creates or truncates a file and writes all bytes.

fn open_append(&self, path: &Path) -> Result<Box<dyn VfsFile>>

Opens or creates one file for handle-oriented append-only writes.

fn rename(&self, from: &Path, to: &Path) -> Result<()>

Atomically renames one path over another according to platform semantics.

fn sync(&self, path: &Path, kind: SyncKind) -> Result<()>

Synchronizes a file or directory using an explicit platform primitive.

fn list(&self, directory: &Path) -> Result<Vec<PathBuf>>

Lists direct children of a directory.

fn for_each_direct_child( &self, directory: &Path, visitor: &mut dyn FnMut(&Path) -> Result<()>, ) -> Result<()>

Visits direct children one at a time without collecting the directory.

fn delete(&self, path: &Path) -> Result<()>

Deletes one file.