Struct FileCache

pub struct FileCache { /* private fields */ }

Cache for storing file analysis results and metadata

Implementations

impl FileCache

pub fn new<P: AsRef<Path>>(cache_path: P) -> Self

Create a new file cache with the given cache file path

pub fn load(&mut self) -> GuardianResult<()>

Load cache from disk, creating it if it doesn’t exist

pub fn save(&mut self) -> GuardianResult<()>

Save cache to disk if it has been modified

pub fn needs_analysis<P: AsRef<Path>>( &mut self, file_path: P, config_fingerprint: &str, ) -> GuardianResult<bool>

Check if a file needs to be re-analyzed

pub fn update_entry<P: AsRef<Path>>( &mut self, file_path: P, violation_count: usize, config_fingerprint: &str, ) -> GuardianResult<()>

Update cache entry for a file after analysis

pub fn statistics(&self) -> CacheStatistics

Get cache statistics

pub fn clear(&mut self) -> GuardianResult<()>

Clear the entire cache

pub fn cleanup(&mut self) -> GuardianResult<usize>

Remove cache entries for files that no longer exist

pub fn set_config_fingerprint(&mut self, fingerprint: String)

Update configuration fingerprint

impl FileCache

pub fn validate_cache_coherence(&self) -> GuardianResult<()>

Self-validation - Infrastructure validates its own coherence

Architecture Principle: Self-validating infrastructure - Components ensure their own correctness

• Cache validates its invariants during normal operation
• File hash verification maintains cache coherence
• Metadata consistency checked on each operation
• No external test dependencies - system is self-aware

Trait Implementations

impl Debug for FileCache

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

Formats the value using the given formatter.