Struct FsManager 

pub struct FsManager { /* private fields */ }

Manages filesystem operations with request batching and deduplication

The FsManager sits between the application and the filesystem backend, providing optimizations like:

• Request deduplication (multiple requests for the same path)
• Batching of metadata requests
• Centralized error handling

This wraps a FileSystem trait object and provides async methods using spawn_blocking internally.

Implementations

impl FsManager

pub fn new(fs: Arc<dyn FileSystem + Send + Sync>) -> Self

Create a new filesystem manager with the given filesystem implementation

pub async fn list_dir(&self, path: PathBuf) -> Result<Vec<DirEntry>>

List directory contents with request deduplication

If multiple requests for the same directory are made concurrently, only one filesystem operation will be performed and all requesters will receive the same result.

pub async fn get_metadata( &self, paths: Vec<PathBuf>, ) -> Vec<Result<FileMetadata>>

Get metadata for multiple paths efficiently

This fetches metadata in parallel using spawn_blocking.

Returns a result for each path in the same order as the input.

pub async fn get_single_metadata(&self, path: &Path) -> Result<FileMetadata>

Get metadata for a single path

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

Check if a path exists

pub async fn is_dir(&self, path: &Path) -> Result<bool>

Check if a path is a directory

pub async fn get_entry(&self, path: &Path) -> Result<DirEntry>

Get a complete entry for a path (with metadata)

pub async fn canonicalize(&self, path: &Path) -> Result<PathBuf>

Get canonical path

pub async fn list_dir_with_metadata( &self, path: PathBuf, ) -> Result<Vec<DirEntry>>

List directory and fetch metadata for all entries in parallel

This is a convenience method that combines list_dir with get_metadata to get complete information about all entries.

pub fn filesystem(&self) -> &Arc<dyn FileSystem + Send + Sync>

Get the underlying filesystem implementation

Trait Implementations

impl Clone for FsManager

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FsManager

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

Formats the value using the given formatter.