Struct DiskBoundedCache 

pub struct DiskBoundedCache { /* private fields */ }

A disk-space-bounded LRU proxy cache that automatically evicts entries when the configured space limit would be exceeded.

Unlike the simpler ProxyCache, DiskBoundedCache:

• Enforces a hard disk-space ceiling on insertions.
• Uses LRU eviction automatically upon every insertion that would violate the limit.
• Maintains hit/miss/eviction counters for telemetry.
• Supports lookup with automatic LRU touch.

Implementations

impl DiskBoundedCache

pub fn new(max_bytes: u64) -> Result<Self, String>

Create a new cache with a disk-space limit of max_bytes.

Errors

Returns a descriptive string if max_bytes is zero.

pub fn insert(&mut self, path: &str, size_bytes: u64, now_ms: u64) -> bool

Insert a proxy entry identified by path with size_bytes and access time now_ms.

If an entry with the same path already exists it is updated in-place (moved to the MRU end). Before inserting, LRU entries are evicted until the new entry fits within the space limit. If the single entry itself is larger than the limit, the insert is rejected and false is returned.

Returns true when the entry was inserted/updated, false when it was rejected.

pub fn access(&mut self, path: &str, now_ms: u64) -> Option<CacheEntry>

Look up a cache entry by path.

On hit: moves the entry to the MRU position and updates access time. On miss: increments the miss counter.

Returns a clone of the entry on hit, or None on miss.

pub fn evict_lru(&mut self) -> Option<String>

Remove and return the path of the least-recently-used entry.

Returns None if the cache is empty.

pub fn clear(&mut self) -> Vec<String>

Remove all entries, returning their paths.

pub fn contains(&self, path: &str) -> bool

Whether the cache contains an entry for path.

pub fn len(&self) -> usize

Number of entries in the cache.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

pub fn used_bytes(&self) -> u64

Current total used bytes.

pub fn max_bytes(&self) -> u64

Maximum allowed bytes.

pub fn utilization(&self) -> f64

Cache utilisation fraction in [0.0, 1.0].

pub fn stats(&self) -> DiskCacheStats

Collect and return a statistics snapshot.

Trait Implementations

impl Debug for DiskBoundedCache

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

Formats the value using the given formatter.