Struct ContentCache 

pub struct ContentCache { /* private fields */ }

Content cache for tracking file freshness

Design

• Keyed by WorkspaceFilePath (relative path for portability)
• Stores hash + mtime for cache invalidation
• Separate from path identity concerns

Usage

let mut cache = ContentCache::new();

// Register a file
let path = resolver.resolve_relative("src/lib.rs");
cache.register(&path, hash, mtime);

// Check freshness
match cache.check_freshness(&path) {
    Freshness::Fresh => println!("Up to date"),
    Freshness::Stale => println!("Needs rebuild"),
    _ => {}
}

Implementations

impl ContentCache

pub fn new() -> Self

Create a new empty cache

pub fn with_capacity(capacity: usize) -> Self

Create cache with pre-allocated capacity

pub fn register( &mut self, path: &WorkspaceFilePath, hash: u64, mtime: SystemTime, )

Register or update a file in the cache

pub fn register_with_current_mtime( &mut self, path: &WorkspaceFilePath, hash: u64, ) -> Result<()>

Register a file by reading its current mtime (hash provided)

pub fn get(&self, path: &WorkspaceFilePath) -> Option<&CacheEntry>

Get cache entry for a file

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

Check if a file is in the cache

pub fn remove(&mut self, path: &WorkspaceFilePath) -> Option<CacheEntry>

Remove a file from the cache

pub fn check_freshness(&self, path: &WorkspaceFilePath) -> Freshness

Check freshness of a file

Compares cached mtime with current file mtime.

pub fn get_stale_files<'a>( &self, paths: &'a [WorkspaceFilePath], ) -> Vec<&'a WorkspaceFilePath>

Get all stale files (files that have been modified)

pub fn clear(&mut self)

Clear all entries

pub fn len(&self) -> usize

Get number of cached entries

pub fn is_empty(&self) -> bool

Check if cache is empty

pub fn iter(&self) -> impl Iterator<Item = (&PathBuf, &CacheEntry)>

Iterate over all entries

Trait Implementations

impl Clone for ContentCache

fn clone(&self) -> ContentCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentCache

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

Formats the value using the given formatter.

impl Default for ContentCache

fn default() -> ContentCache

Returns the “default value” for a type.