Struct CacheStore 

pub struct CacheStore { /* private fields */ }

Cached module information stored on disk.

Implementations

impl CacheStore

pub fn new() -> CacheStore

Create a new empty cache.

pub fn load( cache_dir: &Path, expected_config_hash: u64, max_size_bytes: usize, ) -> Option<CacheStore>

Load cache from disk.

Returns None when:

• the file does not exist or cannot be read,
• the on-disk size exceeds the configured max_size_bytes (matches the user’s cache.maxSizeMb / FALLOW_CACHE_MAX_SIZE setting, with the built-in DEFAULT_CACHE_MAX_SIZE as the lower bound so a misconfigured tiny cap cannot push a still-valid larger cache into discard),
• bitcode decoding fails or the decoded version differs from CACHE_VERSION (emits a one-line tracing::info! so the user sees the one-time rebuild cost; decode failure is the common case across CACHE_VERSION bumps because the on-disk schema changes shape and the new struct cannot deserialize the old bytes),
• the on-disk config_hash differs from expected_config_hash (silent; config changes are user-driven and routine, no log noise).

pub fn save( &mut self, cache_dir: &Path, config_hash: u64, max_size_bytes: usize, ) -> Result<(), String>

Save cache to disk with write-time size enforcement and atomic rename.

Algorithm:

1. Set self.config_hash = config_hash.
2. Encode once.
3. If the encoded size exceeds 80% of max_size_bytes, evict LRU entries (oldest last_access_secs first, path-tiebroken) until the size is below 60% of max_size_bytes OR only one entry remains. Re-encode after eviction.
4. Write the bytes to cache.bin.tmp then rename to cache.bin. This bounds the partial-truncate window that a plain std::fs::write would expose mid-write.

Errors

Returns an error string when the cache directory cannot be created or the temporary file cannot be written or renamed.

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 Debug for CacheStore

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

Formats the value using the given formatter.

impl Default for CacheStore

fn default() -> CacheStore

Returns the “default value” for a type.

impl<'__de> Decode<'__de> for CacheStore

impl Encode for CacheStore