Struct StubCache 

pub struct StubCache { /* private fields */ }

Per-JAR stub cache keyed by SHA-256 hash of the JAR file.

Cache location: .sqry/classpath/jars/{hash}.stub Format: postcard binary serialization of Vec<ClassStub>

Thread safety

StubCache is Send + Sync (all fields are owned, no interior mutability). Multiple threads may call get concurrently. Concurrent put calls for different JAR files are safe because they write to different files. Concurrent puts for the same JAR file are idempotent (last writer wins via atomic rename).

Implementations

impl StubCache

pub fn new(project_root: &Path) -> Self

Create a new stub cache rooted at the given project directory.

The cache directory (.sqry/classpath/jars/) is created lazily on first write.

pub fn get(&self, jar_path: &Path) -> Option<Vec<ClassStub>>

Try to load cached stubs for a JAR file.

Returns None on cache miss, corrupt cache, hash computation failure, or I/O error. Errors are logged as warnings but never propagated.

pub fn put(&self, jar_path: &Path, stubs: &[ClassStub]) -> ClasspathResult<()>

Cache parsed stubs for a JAR file.

Uses atomic write (temp file + rename) to prevent corrupt reads.

Errors

Returns ClasspathError::CacheError if the cache key cannot be computed or the cache directory cannot be created. Serialization and I/O failures during write are returned as CacheError.

Trait Implementations

impl Clone for StubCache

fn clone(&self) -> StubCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StubCache

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

Formats the value using the given formatter.