Struct DiskCache 

pub struct DiskCache { /* private fields */ }

Disk-backed pipeline cache. Writes one file per fingerprint under <root>/<hex>.bin. Reads are stateless; writes are write + rename for atomicity. No eviction policy today (user decides) - the footprint is bounded by sum(artifact_size × unique_canonical_programs).

Implementations

impl DiskCache

pub fn new(root: impl Into<PathBuf>) -> Result<Self, DiskCacheError>

Construct a cache rooted at root. Creates the directory if it doesn’t exist.

Errors

Returns DiskCacheError::Io when the directory can’t be created.

pub fn in_user_cache() -> Result<Self, DiskCacheError>

Construct a cache rooted at ~/.cache/vyre/pipelines/ (or $XDG_CACHE_HOME/vyre/pipelines/ if set).

Errors

Returns DiskCacheError::CacheDirUnknown when neither env var resolves, or DiskCacheError::Io on mkdir failure.

pub fn root(&self) -> &Path

Root directory this cache operates on.

Trait Implementations

impl Debug for DiskCache

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

Formats the value using the given formatter.

impl PipelineCacheStore for DiskCache

fn get(&self, fp: &PipelineFingerprint) -> Option<Vec<u8>>

Look up a cached artifact for this fingerprint.

fn put(&self, fp: PipelineFingerprint, artifact: Vec<u8>)

Insert a pre-compiled artifact. Implementations may dedupe or evict per their own policy.

fn flush(&self) -> Result<()>

Durably flush artifacts that were accepted by Self::put.

fn metrics(&self) -> PipelineCacheMetrics

Snapshot cache instrumentation for latency, throughput, and eviction gates. Backends that do not maintain counters return zeros.

fn get_arc(&self, fp: &PipelineFingerprint) -> Option<Arc<Vec<u8>>>

V7-PERF-009: zero-clone hot-path lookup. Returns the cached artifact as an Arc<Vec<u8>> so multiple consumers share the underlying allocation. Default impl wraps get; in-memory and layered caches override this to return their internal Arc directly.