Struct MountableFs 

pub struct MountableFs { /* private fields */ }

A composite filesystem that delegates to mounted backends via longest-prefix matching.

Example

use rust_bash::{RustBashBuilder, InMemoryFs, MountableFs, OverlayFs};
use std::sync::Arc;

let mountable = MountableFs::new()
    .mount("/", Arc::new(InMemoryFs::new()))
    .mount("/project", Arc::new(OverlayFs::new("./myproject").unwrap()));

let mut shell = RustBashBuilder::new()
    .fs(Arc::new(mountable))
    .cwd("/")
    .build()
    .unwrap();

Implementations

impl MountableFs

pub fn new() -> Self

Create an empty MountableFs with no mount points.

pub fn mount(self, path: impl Into<PathBuf>, fs: Arc<dyn VirtualFs>) -> Self

Mount a filesystem backend at the given absolute path.

Paths must be absolute. Mounting at "/" provides the default fallback. Later mounts at the same path replace earlier ones.

Trait Implementations

impl Default for MountableFs

fn default() -> Self

Returns the “default value” for a type.

impl VirtualFs for MountableFs

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

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

fn append_file(&self, path: &Path, content: &[u8]) -> Result<(), VfsError>

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

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

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

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

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

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

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

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

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

fn chmod(&self, path: &Path, mode: u32) -> Result<(), VfsError>

fn utimes(&self, path: &Path, mtime: SystemTime) -> Result<(), VfsError>

fn symlink(&self, target: &Path, link: &Path) -> Result<(), VfsError>

fn hardlink(&self, src: &Path, dst: &Path) -> Result<(), VfsError>

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

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

fn copy(&self, src: &Path, dst: &Path) -> Result<(), VfsError>

fn rename(&self, src: &Path, dst: &Path) -> Result<(), VfsError>

fn glob(&self, pattern: &str, cwd: &Path) -> Result<Vec<PathBuf>, VfsError>

fn deep_clone(&self) -> Arc<dyn VirtualFs>

Create an independent deep copy for subshell isolation.

fn glob_with_opts( &self, pattern: &str, cwd: &Path, _opts: &GlobOptions, ) -> Result<Vec<PathBuf>, VfsError>

Glob expansion with shopt-controlled options (dotglob, nocaseglob, globstar).