Crate vfs

Virtual file system abstraction

The virtual file system abstraction generalizes over file systems and allow using different VirtualFileSystem implementations (i.e. an in memory implementation for unit tests)

The main interaction with the virtual filesystem is by using virtual paths (VfsPath).

This crate currently has the following implementations:

• PhysicalFS - the actual filesystem of the underlying OS
• MemoryFS - an ephemeral in-memory implementation (intended for unit tests)
• AltrootFS - a file system with its root in a particular directory of another filesystem
• OverlayFS - a union file system consisting of a read/writable upper layer and several read-only lower layers
• EmbeddedFS - a read-only file system embedded in the executable, requires embedded-fs feature

Usage Examples

use vfs::{VfsPath, PhysicalFS, VfsError};

let root: VfsPath = PhysicalFS::new(std::env::current_dir().unwrap()).into();
assert!(root.exists()?);

let mut content = String::new();
root.join("README.md")?.open_file()?.read_to_string(&mut content)?;
assert!(content.contains("vfs"));

use vfs::{VfsPath, VfsError, MemoryFS};

let root: VfsPath = MemoryFS::new().into();
let path = root.join("test.txt")?;
assert!(!path.exists()?);

path.create_file()?.write_all(b"Hello world")?;
assert!(path.exists()?);
let mut content = String::new();
path.open_file()?.read_to_string(&mut content)?;
assert_eq!(content, "Hello world");

Re-exports

pub use error::VfsError;

pub use error::VfsResult;

pub use filesystem::FileSystem;

pub use impls::altroot::AltrootFS;

pub use impls::embedded::EmbeddedFS;

pub use impls::memory::MemoryFS;

pub use impls::overlay::OverlayFS;

pub use impls::physical::PhysicalFS;

pub use path::*;

Modules

async_vfs

Asynchronous port of virtual file system abstraction

error

Error and Result definitions

filesystem

The filesystem trait definitions needed to implement new virtual filesystems

impls

Virtual filesystem implementations

path

Virtual filesystem path