Struct SymbolCache 

pub struct SymbolCache { /* private fields */ }

Shared symbol cache that can be pre-warmed in a background thread and read by all parser instances.

Implementations

impl SymbolCache

pub fn new() -> Self

pub fn set_project_root(&mut self, project_root: PathBuf)

Set the project root used for disk persistence.

pub fn set_project_root_for_generation( &mut self, generation: u64, project_root: PathBuf, ) -> bool

Set the project root only when the caller still belongs to the active cache generation.

pub fn insert( &mut self, path: PathBuf, mtime: SystemTime, size: u64, content_hash: Hash, symbols: Vec<Symbol>, )

Insert pre-warmed symbols for a file.

pub fn insert_for_generation( &mut self, generation: u64, path: PathBuf, mtime: SystemTime, size: u64, content_hash: Hash, symbols: Vec<Symbol>, ) -> bool

Insert symbols only when the caller still belongs to the active cache generation.

pub fn get(&self, path: &Path, mtime: SystemTime) -> Option<Vec<Symbol>>

Return cached symbols when the source file is still fresh.

pub fn symbol_count_if_metadata_matches( &self, path: &Path, mtime: SystemTime, size: u64, ) -> Option<usize>

Return a cached symbol count when file metadata exactly matches the cache entry.

This is the fast path for directory file-tree summaries: when mtime and size are unchanged, callers can use the count without cloning symbols or re-reading the file to verify a content hash.

pub fn contains_path_with_mtime(&self, path: &Path, mtime: SystemTime) -> bool

Whether the cache has a still-valid entry for the given file mtime.

pub fn load_from_disk( &mut self, storage_dir: &Path, project_key: &str, current_root: &Path, ) -> usize

Load valid symbol entries from disk, dropping only entries whose source file changed.

pub fn load_from_disk_for_generation( &mut self, generation: u64, storage_dir: &Path, project_key: &str, current_root: &Path, ) -> usize

Load valid symbol entries from disk only when the caller still belongs to the active cache generation.

pub fn invalidate(&mut self, path: &Path)

Invalidate cached symbols for a specific file.

pub fn reset(&mut self) -> u64

Clear all entries and advance the generation to ignore stale background writers.

pub fn generation(&self) -> u64

Current generation token.

pub fn contains_key(&self, path: &Path) -> bool

Whether the cache has an entry for a file.

pub fn len(&self) -> usize

Number of cached entries.

Trait Implementations

impl Clone for SymbolCache

fn clone(&self) -> SymbolCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SymbolCache

fn default() -> SymbolCache

Returns the “default value” for a type.