Struct VirtualFileSystem 

pub struct VirtualFileSystem { /* private fields */ }

In-memory virtual filesystem for WASM and testing.

This implementation stores files in a HashMap, allowing the loader to resolve includes without actual filesystem access. This is essential for WASM environments where filesystem access is not available.

Example

use rustledger_loader::VirtualFileSystem;
use std::path::PathBuf;

let mut vfs = VirtualFileSystem::new();
vfs.add_file("main.beancount", "include \"accounts.beancount\"");
vfs.add_file("accounts.beancount", "2024-01-01 open Assets:Bank USD");

Implementations

impl VirtualFileSystem

pub fn new() -> Self

Create a new empty virtual filesystem.

pub fn add_file(&mut self, path: impl AsRef<Path>, content: impl Into<String>)

Add a file to the virtual filesystem.

The path is normalized to handle different path separators and relative paths consistently.

pub fn add_files( &mut self, files: impl IntoIterator<Item = (impl AsRef<Path>, impl Into<String>)>, )

Add multiple files from a map.

This is a convenience method for adding many files at once.

pub fn from_files( files: impl IntoIterator<Item = (impl AsRef<Path>, impl Into<String>)>, ) -> Self

Create a virtual filesystem from a map of files.

pub fn len(&self) -> usize

Get the number of files in the virtual filesystem.

pub fn is_empty(&self) -> bool

Check if the virtual filesystem is empty.

Trait Implementations

impl Clone for VirtualFileSystem

fn clone(&self) -> VirtualFileSystem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualFileSystem

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

Formats the value using the given formatter.

impl Default for VirtualFileSystem

fn default() -> VirtualFileSystem

Returns the “default value” for a type.

impl FileSystem for VirtualFileSystem

fn read(&self, path: &Path) -> Result<Arc<str>, LoadError>

Read file content at the given path.

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

Check if a file exists at the given path.

fn is_encrypted(&self, _path: &Path) -> bool

Check if a path is a GPG-encrypted file.

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

Normalize a path for this filesystem.

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

Expand a glob pattern and return matching paths.