Struct CachingDirectory 

pub struct CachingDirectory<D: Directory> { /* private fields */ }

Caching wrapper for any Directory - caches file reads

Implementations

impl<D: Directory> CachingDirectory<D>

pub fn new(inner: D, max_cached_bytes: usize) -> Self

Trait Implementations

impl<D: Directory> Directory for CachingDirectory<D>

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if a file exists

fn file_size<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get file size

fn open_read<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<FileHandle>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Open a file for reading (loads entire file into an inline FileHandle)

fn read_range<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, range: Range<u64>, ) -> Pin<Box<dyn Future<Output = Result<OwnedBytes>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a specific byte range from a file (optimized for network)

fn list_files<'life0, 'life1, 'async_trait>( &'life0 self, prefix: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<PathBuf>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List files in directory

fn open_lazy<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<FileHandle>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Open a file handle that fetches ranges on demand. For mmap directories this returns an Inline handle (sync-capable). For HTTP/filesystem directories this returns a Lazy handle.

fn set_index_label(&self, label: &str)

Attach the owning index’s name for Directory-layer metric labels (summa_directory_read_*, summa_cold_write_bytes_total). Called by Index::open/create once the schema is loaded; wrappers forward to their inner directory. Default: no-op (directories that emit no Directory-layer metrics, e.g. RamDirectory).

fn local_path(&self, path: &Path) -> Option<PathBuf>

Resolve a directory-relative file to a native filesystem path.