Struct FileCache 

pub struct FileCache { /* private fields */ }

Enhanced file cache with quick-cache for high-performance caching

Uses tokio::sync::Mutex for async-safe stats access across .await boundaries. Stores Arc<Value> internally for zero-copy cache hits. See: https://ratatui.rs/faq/

Implementations

impl FileCache

pub fn new(capacity: usize) -> Self

pub async fn get_file(&self, key: &str) -> Option<Value>

Get cached file content (clones the value for backwards compatibility)

pub async fn get_file_arc(&self, key: &str) -> Option<Arc<Value>>

Get cached file content as Arc for zero-copy access

pub fn put_file( &self, key: String, value: Value, ) -> impl Future<Output = ()> + '_

Cache file content

pub async fn put_file_arc(&self, key: String, value: Arc<Value>)

Cache file content with pre-wrapped Arc for zero-copy insertion

pub async fn get_directory(&self, key: &str) -> Option<Value>

Get cached directory listing (clones for backwards compatibility)

pub async fn get_directory_arc(&self, key: &str) -> Option<Arc<Value>>

Get cached directory listing as Arc for zero-copy access

pub fn put_directory( &self, key: String, value: Value, ) -> impl Future<Output = ()> + '_

Cache directory listing

pub async fn put_directory_arc(&self, key: String, value: Arc<Value>)

Cache directory listing with pre-wrapped Arc

pub async fn stats(&self) -> EnhancedCacheStats

Get cache statistics

pub async fn clear(&self)

Clear all caches

pub fn capacity(&self) -> (usize, usize)

Get cache capacity information

pub fn len(&self) -> (usize, usize)

Get current cache size

pub async fn check_pressure_and_evict(&self)

Check memory pressure and enforce limits with tiered eviction

pub fn set_capacity_limit(&mut self, max_bytes: usize)

Set explicit memory limit in bytes

pub fn apply_read_cache_config(&self, config: &FileReadCacheConfig)

Update cache policy from configuration

pub fn adjust_capacity(&self, target_memory_ratio: f64)

Adjust cache capacity based on system memory availability. target_memory_ratio: 0.0 to 1.0 (fraction of total system memory to use).