Struct CacheStore 

pub struct CacheStore { /* private fields */ }

A file-based cache store for scan findings. Every entry is signed with the store’s CacheKey; an unsigned or tampered entry reads as a miss.

Implementations

impl CacheStore

pub fn with_dir(dir: PathBuf, key: CacheKey) -> Self

Create a cache store that writes directly to dir, signing its entries with key.

pub fn scoped_to_rules(self, rules_hash: &str) -> Self

Scope this store’s entries to a ruleset. Entries written by a scan with a different active ruleset use a different prefix, so a concurrent scan with fewer or disabled rules cannot serve its (correctly empty) result to a scan that expects the full ruleset to fire.

pub fn dir(&self) -> &Path

pub fn check_rules_changed( &self, current_hash: &str, ) -> Result<bool, CacheError>

Check if the rules have changed since the last scan. If they have, invalidate the entire cache.

pub fn get(&self, file_hash: &str) -> Option<CacheEntry>

Look up a file’s cached scan result by its content hash. An entry whose signature does not verify is ignored.

pub fn put(&self, file_hash: &str, entry: &CacheEntry) -> Result<(), CacheError>

Store a file’s scan result, identified by its content hash and signed with the store’s key.

pub fn cleanup(&self, current_hashes: &[String]) -> Result<usize, CacheError>

Remove cache entries whose hash no longer appears in the set of current file hashes.