Struct PersistentFingerprintCache 

pub struct PersistentFingerprintCache { /* private fields */ }

Cross-session persistent cache mapping file paths to their fingerprints.

Entries are keyed by path string.

Implementations

impl PersistentFingerprintCache

pub fn new(cache_path: PathBuf) -> Self

Create a new, empty cache backed by cache_path.

The file is not read or written until save or load is called.

pub fn load(cache_path: PathBuf) -> Result<Self>

Load a cache from cache_path.

Returns an empty cache (rather than an error) if the file does not exist. Returns Err only on genuine I/O or parse failures.

Errors

Returns an io::Error if the file exists but cannot be read or parsed.

pub fn save(&self) -> Result<()>

Save the cache to disk atomically (write temp → rename).

Errors

Returns an io::Error if writing or renaming fails.

pub fn insert(&mut self, entry: CachedEntry)

Insert or update a CachedEntry.

pub fn remove(&mut self, path: &str) -> Option<CachedEntry>

Remove the entry for path, returning it if it existed.

pub fn len(&self) -> usize

Return the number of entries in the cache.

pub fn is_empty(&self) -> bool

Return true if the cache contains no entries.

pub fn get(&self, path: &str) -> Option<&CachedEntry>

Look up a cached entry by file path without freshness checking.

Use get_valid to validate against on-disk state.

pub fn get_valid(&mut self, path: &str) -> Option<&CachedEntry>

Look up a cached entry, validating that the stored BLAKE3 digest still matches the current file.

Reads the actual file to recompute its BLAKE3 hash. Returns None if:

• The entry is not in the cache.
• The file does not exist.
• The digest has changed (file was modified).

Updates the internal hit/miss counters.

pub fn hits(&self) -> u64

Return the number of cache hits since the cache was loaded or last reset.

pub fn misses(&self) -> u64

Return the number of cache misses since the cache was loaded or last reset.

pub fn hit_rate(&self) -> f64

Return the hit rate (0.0 – 1.0). Returns 0.0 if no lookups have been made.

pub fn reset_stats(&mut self)

Reset hit/miss counters.

pub fn evict_missing(&mut self) -> usize

Evict all entries whose source file no longer exists on disk.

Returns the number of entries evicted.

pub fn evict_stale(&mut self) -> usize

Evict all entries that are stale (file modified since caching).

Recomputes BLAKE3 hashes for all cached files. Entries are removed when the digest no longer matches. Returns the number of entries evicted.

pub fn merge_from(&mut self, other: &Self)

Merge entries from other into this cache.

Entries in other overwrite entries with the same path in self.

pub fn iter(&self) -> impl Iterator<Item = (&String, &CachedEntry)>

Return an iterator over all cached entries.

Trait Implementations

impl Clone for PersistentFingerprintCache

fn clone(&self) -> PersistentFingerprintCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PersistentFingerprintCache

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

Formats the value using the given formatter.