Trait FileSystem 

pub trait FileSystem: Send + Sync {
    // Required methods
    fn now(&self) -> SystemTime;
    fn exists(&self, path: &Path) -> bool;
    fn metadata(&self, path: &Path) -> Result<Metadata>;
    fn symlink_metadata(&self, path: &Path) -> Result<Metadata>;
    fn create_dir_all(&self, path: &Path) -> Result<()>;
    fn create_dir(&self, path: &Path) -> Result<()>;
    fn write(&self, path: &Path, data: &[u8]) -> Result<()>;
    fn write_to_string(&self, path: &Path, content: &str) -> Result<()>;
    fn read_to_string(&self, path: &Path) -> Result<String>;
    fn remove_file(&self, path: &Path) -> Result<()>;
    fn rename(&self, from: &Path, to: &Path) -> Result<()>;
    fn list_dir(&self, path: &Path) -> Result<Vec<PathBuf>>;
    fn remove_dir(&self, path: &Path) -> Result<()>;
}

Filesystem abstraction boundary for command implementations.

Keeping this trait narrow makes it easy to write deterministic tests and allows alternative backends (e.g. in-memory fs) if command crates need it.

Required Methods

fn now(&self) -> SystemTime

Returns the current time in wall-clock format.

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

Returns true when path exists (symlink-aware).

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

Reads file metadata.

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

Reads symlink metadata.

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

Creates a directory and all missing parent directories.

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

Creates a directory.

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

Writes raw bytes atomically (truncate + replace).

fn write_to_string(&self, path: &Path, content: &str) -> Result<()>

Writes UTF-8 text.

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

Reads UTF-8 text.

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

Removes a file.

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

Renames/moves a path.

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

Lists directory children as concrete paths.

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

Removes an empty directory.

Implementors

impl FileSystem for RealFileSystem