kaish-vfs 0.8.2

kaish VFS contract: the Filesystem trait and the LocalFs/MemoryFs backends
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! kaish's virtual filesystem contract.
//!
//! This leaf crate holds the [`Filesystem`] trait every VFS backend implements
//! and the [`LocalFs`] real-filesystem backend. It exists so backends that
//! aren't part of the kernel — most importantly `GitVfs`, which wraps a
//! `LocalFs` working tree — can live in their own crates without depending on
//! `kaish-kernel`.
//!
//! `DirEntry`/`DirEntryKind` (the data the trait traffics in) live one layer
//! down in `kaish-types` and are re-exported here for convenience.

mod budget;
mod traits;

pub use budget::ByteBudget;
pub use traits::{DirEntry, DirEntryKind, Filesystem};

// `LocalFs` pulls in `tokio/fs`; gated so the in-memory/wasm sandbox build
// (which doesn't enable `localfs`) stays free of a real-filesystem dependency.
#[cfg(feature = "localfs")]
mod local;
#[cfg(feature = "localfs")]
pub use local::LocalFs;

// `MemoryFs` only needs `tokio/sync` (runtime-free), but gated so the bare
// trait-only build stays dependency-free.
#[cfg(feature = "memory")]
mod memory;
#[cfg(feature = "memory")]
pub use memory::MemoryFs;

// Copy-on-write overlay: writes land in an upper layer, the lower is never
// touched. Design: docs/kaish-overlayfs.md.
#[cfg(feature = "overlay")]
mod overlay;
#[cfg(feature = "overlay")]
pub use overlay::{ChangeKind, OverlayChange, OverlayFs};

#[cfg(any(feature = "memory", feature = "overlay"))]
mod paths;