Struct CountingVfs 

pub struct CountingVfs<V> { /* private fields */ }

Byte/call-counting decorator used by deterministic open-cost gates.

Implementations

impl<V> CountingVfs<V>

pub fn new(inner: V) -> Self

Wraps a filesystem with zeroed counters.

pub fn with_read_path_filter(self, path: impl Into<PathBuf>) -> Self

Counts successful reads of one exact path separately from global reads.

pub const fn inner(&self) -> &V

Returns the wrapped filesystem.

pub fn open_calls(&self) -> u64

Returns observed open calls.

pub fn open_for_map_calls(&self) -> u64

Returns observed mapping-file open calls.

pub fn read_calls(&self) -> u64

Returns observed read calls.

pub fn filtered_read_calls(&self) -> u64

Returns successful reads matching the configured exact path.

pub fn read_bytes(&self) -> u64

Returns exact bytes returned by reads.

pub fn segment_bytes_read(&self) -> u64

Returns exact bytes read from immutable segment paths.

pub fn write_calls(&self) -> u64

Returns observed whole-file write calls.

pub fn bytes_written(&self) -> u64

Returns exact bytes supplied to successful whole-file writes.

pub fn append_calls(&self) -> u64

Returns observed successful handle append calls.

pub fn bytes_appended(&self) -> u64

Returns exact bytes supplied to successful handle appends.

pub fn rename_calls(&self) -> u64

Returns observed successful rename calls.

pub fn delete_calls(&self) -> u64

Returns observed successful delete calls.

pub fn enumerate_calls(&self) -> u64

Returns observed streaming directory-enumeration calls.

pub fn barrier_sync_calls(&self) -> u64

Returns path-based barrier synchronization calls.

pub fn full_sync_calls(&self) -> u64

Returns path-based full synchronization calls.

pub fn handle_barrier_sync_calls(&self) -> u64

Returns open-handle barrier synchronization calls.

pub fn handle_full_sync_calls(&self) -> u64

Returns open-handle full synchronization calls.

pub fn reset(&self)

Resets all counters without changing the wrapped filesystem.

Trait Implementations

impl<V: Vfs> Vfs for CountingVfs<V>

fn truncate(&self, path: &Path, length: u64) -> Result<()>

Removes a suffix without copying the retained file bytes.

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

Exclusively creates a file and writes every byte without replacing any existing path. A failed write may leave a new partial file; callers must retain it as an uncommitted artifact until safe cleanup is established. Filesystems without atomic exclusive creation fail explicitly.

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

Exclusively creates one directory. Existing paths are preserved and reported as AlreadyExists; no ancestor is adopted implicitly.

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

Removes one empty directory. A non-empty directory is an error.

fn ensure_directory(&self, path: &Path, create: bool) -> Result<bool>

Admits a store directory, creating missing ancestors when requested, and reports whether the resulting path is a directory.

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

Opens an existing path and returns its byte length.

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

Opens an existing path as an owned file suitable for memory mapping.

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

Reads an entire file.

fn read_range(&self, path: &Path, offset: u64, length: usize) -> Result<Vec<u8>>

Reads at most length bytes beginning at offset.

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

Creates or truncates a file and writes all bytes.

fn open_append(&self, path: &Path) -> Result<Box<dyn VfsFile>>

Opens or creates one file for handle-oriented append-only writes.

fn rename(&self, from: &Path, to: &Path) -> Result<()>

Atomically renames one path over another according to platform semantics.

fn sync(&self, path: &Path, kind: SyncKind) -> Result<()>

Synchronizes a file or directory using an explicit platform primitive.

fn list(&self, directory: &Path) -> Result<Vec<PathBuf>>

Lists direct children of a directory.

fn for_each_direct_child( &self, directory: &Path, visitor: &mut dyn FnMut(&Path) -> Result<()>, ) -> Result<()>

Visits direct children one at a time without collecting the directory.

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

Deletes one file.