Struct VirtualFilesystem 

pub struct VirtualFilesystem { /* private fields */ }

In-memory virtual filesystem implementing FileSystemProvider.

Thread-safe via internal RwLock. Designed for sandbox mode where no real disk access is permitted.

Implementations

impl VirtualFilesystem

pub fn new(max_size: usize) -> Self

Create a new empty VFS with the given maximum total size in bytes.

max_size of 0 means unlimited.

pub fn seed_file(&self, path: impl Into<PathBuf>, content: Vec<u8>)

Pre-seed a read-only file. Typically called by the host before executing a sandboxed program (e.g., from [sandbox.seed_files]).

pub fn seed_dir(&self, path: impl Into<PathBuf>)

Seed a directory (empty). Automatically seeds all parent directories.

pub fn extract_written_files(&self) -> HashMap<PathBuf, Vec<u8>>

Extract all files written by the sandboxed program (excludes seed files).

Returns a map from path to file content.

pub fn total_bytes_written(&self) -> usize

Total bytes written by the sandboxed program (excludes seed files).

Trait Implementations

impl FileSystemProvider for VirtualFilesystem

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

Read the entire contents of a file.

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

Write data to a file, creating or truncating as needed.

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

Append data to a file.

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

Check whether a path exists.

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

Remove a file.

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

List entries in a directory.

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

Query metadata for a path.

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

Recursively create directories.