Struct CacheStore 

pub struct CacheStore { /* private fields */ }

Cached module information stored on disk.

Implementations

impl CacheStore

pub fn new() -> Self

Create a new empty cache.

pub fn load(cache_dir: &Path) -> Option<Self>

Load cache from disk.

pub fn save(&self, cache_dir: &Path) -> Result<(), String>

Save cache to disk.

Errors

Returns an error string when the cache directory cannot be created, the cache cannot be serialized, or the cache file cannot be written.

pub fn get(&self, path: &Path, content_hash: u64) -> Option<&CachedModule>

Look up a cached module by path and content hash. Returns None if not cached or hash mismatch.

pub fn insert(&mut self, path: &Path, module: CachedModule)

Insert or update a cached module.

pub fn get_by_metadata( &self, path: &Path, mtime_secs: u64, file_size: u64, ) -> Option<&CachedModule>

Fast cache lookup using only file metadata (mtime + size).

If the cached entry has matching mtime and size, the file content almost certainly has not changed, so we can skip reading the file entirely. This turns a cache hit from stat() + read() + hash into just stat().

pub fn get_by_path_only(&self, path: &Path) -> Option<&CachedModule>

Look up a cached module by path only (ignoring hash). Used to check whether a module’s content hash matches without requiring the caller to know the hash upfront.

pub fn retain_paths(&mut self, files: &[DiscoveredFile])

Remove cache entries for files that are no longer in the project. Keeps the cache from growing unboundedly as files are deleted.

pub fn len(&self) -> usize

Number of cached entries.

pub fn is_empty(&self) -> bool

Whether cache is empty.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for CacheStore

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl Debug for CacheStore

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for CacheStore

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Default for CacheStore

fn default() -> Self

Returns the “default value” for a type.

impl Encode for CacheStore

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.