Struct StdFileSystem 

pub struct StdFileSystem;

Standard filesystem implementation using std::fs

This is the default implementation for native builds.

Implementations

impl StdFileSystem

pub fn current_user_groups() -> (u32, Vec<u32>)

Get the current user’s effective UID and all group IDs (primary + supplementary).

Trait Implementations

impl Clone for StdFileSystem

fn clone(&self) -> StdFileSystem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StdFileSystem

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

Formats the value using the given formatter.

impl Default for StdFileSystem

fn default() -> StdFileSystem

Returns the “default value” for a type.

impl FileSystem for StdFileSystem

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

Read entire file into memory

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

Read a range of bytes from a file (for lazy loading large files)

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

Write data to file atomically (temp file + rename)

fn create_file(&self, path: &Path) -> Result<Box<dyn FileWriter>>

Create a file for writing, returns a writer handle

fn open_file(&self, path: &Path) -> Result<Box<dyn FileReader>>

Open a file for reading, returns a reader handle

fn open_file_for_write(&self, path: &Path) -> Result<Box<dyn FileWriter>>

Open a file for writing in-place (truncating, preserves ownership on Unix)

fn open_file_for_append(&self, path: &Path) -> Result<Box<dyn FileWriter>>

Open a file for appending (creates if doesn’t exist)

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

Set file length (truncate or extend with zeros)

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

Rename/move a file or directory atomically

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

Copy a file (fallback when rename fails across filesystems)

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

Remove a file

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

Remove an empty directory

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

Get file/directory metadata

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

Get symlink metadata (doesn’t follow symlinks)

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

Check if path is a directory

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

Check if path is a file

fn set_permissions( &self, path: &Path, permissions: &FilePermissions, ) -> Result<()>

Set file permissions

fn read_dir(&self, path: &Path) -> Result<Vec<DirEntry>>

List entries in a directory (non-recursive)

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

Create a directory

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

Create a directory and all parent directories

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

Get canonical (absolute, normalized) path

fn current_uid(&self) -> u32

Get the current user’s UID (Unix only, returns 0 on other platforms)

fn sudo_write( &self, path: &Path, data: &[u8], mode: u32, uid: u32, gid: u32, ) -> Result<()>

Write file using sudo (for root-owned files).

fn search_file( &self, path: &Path, pattern: &str, opts: &FileSearchOptions, cursor: &mut FileSearchCursor, ) -> Result<Vec<SearchMatch>>

Search a file on disk for a pattern, returning one batch of matches.

fn count_line_feeds_in_range( &self, path: &Path, offset: u64, len: usize, ) -> Result<usize>

Count \n bytes in a file range without returning the data.

fn write_patched( &self, src_path: &Path, dst_path: &Path, ops: &[WriteOp<'_>], ) -> Result<()>

Write a file using a patch recipe (optimized for remote filesystems).

fn exists(&self, path: &Path) -> bool

Check if path exists

fn metadata_if_exists(&self, path: &Path) -> Option<FileMetadata>

Check if path exists, returns metadata if it does

fn is_writable(&self, path: &Path) -> bool

Check if the current user has write permission to the given path.

fn is_owner(&self, path: &Path) -> bool

Check if the current user is the owner of the file

fn temp_path_for(&self, path: &Path) -> PathBuf

Get a temporary file path for atomic writes

fn unique_temp_path(&self, dest_path: &Path) -> PathBuf

Get a unique temporary file path (using timestamp and PID)

fn remote_connection_info(&self) -> Option<&str>

Get remote connection info if this is a remote filesystem

fn home_dir(&self) -> Result<PathBuf>

Get the home directory for this filesystem

impl Copy for StdFileSystem