Struct FakeFileSystem 

pub struct FakeFileSystem { /* private fields */ }

An in-memory filesystem.

Paths are normalised (. and .. resolved lexically) so callers can hand it either absolute or relative paths and get consistent answers. Interior mutability via Mutex keeps it usable behind the &self trait methods and Send + Sync for the worker thread.

Implementations

impl FakeFileSystem

pub fn new() -> Self

pub fn with_paths(paths: &[&str]) -> Self

Build a tree from a path list. Trailing / means directory; parents are implied.

FakeFileSystem::with_paths(&["/proj/src/main.rs", "/proj/Cargo.toml", "/proj/target/"]);

pub fn add_dir(&self, path: impl AsRef<Path>) -> &Self

Insert a directory and every missing ancestor.

pub fn add_file(&self, path: impl AsRef<Path>, contents: &[u8]) -> &Self

Insert a file with contents, creating missing ancestor directories.

pub fn add_symlink( &self, path: impl AsRef<Path>, target: impl AsRef<Path>, ) -> &Self

Insert a symlink. It is listed but never traversed, matching the real service.

pub fn fail(&self, path: impl AsRef<Path>, error: FsError) -> &Self

Make every operation on path fail with error — for exercising the explorer’s permission-denied and I/O-error rendering without needing a real unreadable dir.

pub fn paths(&self) -> Vec<PathBuf>

Every path currently in the tree, sorted. Useful for asserting after mutations.

Trait Implementations

impl Debug for FakeFileSystem

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

Formats the value using the given formatter.

impl Default for FakeFileSystem

fn default() -> FakeFileSystem

Returns the “default value” for a type.

impl FileSystemService for FakeFileSystem

fn read_dir(&self, path: &Path) -> FsResult<Vec<DirEntryInfo>>

List one directory level. Does not recurse — the tree is lazy (ADR-0005 §2).

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

fn create_file(&self, path: &Path) -> FsResult<()>

Create an empty file. Errors with FsError::AlreadyExists rather than truncating.

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

Replace a file’s contents, creating it if absent.

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

Create a directory, including missing parents.

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

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

fn remove_dir_all(&self, path: &Path) -> FsResult<()>

Recursively delete a directory. Named for what it does: callers must confirm with the user (or hold an agent permission grant) before invoking it.

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

Resolve symlinks and .. to an absolute path. Used as the loop guard when deciding whether a symlinked directory has already been visited.