Struct HashCache 

pub struct HashCache {
    pub version: String,
    pub min_block_size: usize,
    pub git_commit: Option<String>,
    pub created_at: u64,
    pub hash_index: HashMap<u64, Vec<CodeLocation>>,
    pub file_metadata: HashMap<String, FileCacheMetadata>,
}

The complete hash cache for a codebase

Fields

version: String

Version of the cache format (for future compatibility)

min_block_size: usize

Minimum block size (tokens) used to build this cache

git_commit: Option<String>

Git commit hash when cache was built (if available)

created_at: u64

Timestamp when cache was created

hash_index: HashMap<u64, Vec<CodeLocation>>

Map from rolling hash to all locations with that hash

file_metadata: HashMap<String, FileCacheMetadata>

Metadata for all cached files (for invalidation)

Implementations

impl HashCache

pub fn new(min_block_size: usize) -> Self

Create a new empty cache

pub fn add_hash(&mut self, hash: u64, location: CodeLocation)

Add a hash entry to the cache

pub fn lookup(&self, hash: u64) -> Option<&Vec<CodeLocation>>

Look up all locations with a given hash

pub fn file_needs_rescan(&self, file_path: &str) -> bool

Check if a file needs to be rescanned (has changed since cache was built)

pub fn invalidate_file(&mut self, file_path: &str)

Remove all cache entries for a specific file

pub fn invalidate_stale_files(&mut self) -> HashSet<String>

Drop cache entries for files whose metadata no longer matches disk.

Returns the set of file paths that were removed so callers can refresh the cache entries when needed.

pub fn stats(&self) -> CacheStats

Get cache statistics

pub fn save<P: AsRef<Path>>(&self, path: P) -> Result<()>

Save cache to disk

pub fn load<P: AsRef<Path>>(path: P) -> Result<Self>

Load cache from disk

pub fn is_valid<P: AsRef<Path>>(path: P) -> bool

Check if cache exists and is valid

Trait Implementations

impl Clone for HashCache

fn clone(&self) -> HashCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HashCache

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

Formats the value using the given formatter.

impl Default for HashCache

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HashCache

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HashCache

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.