Struct ExactProductCache 

pub struct ExactProductCache { /* private fields */ }

One exact identity/source cache rooted at the caller’s stable product path.

Implementations

impl ExactProductCache

pub fn new( stable_path: impl Into<PathBuf>, identity: ProductIdentity, source: DistributionSource, ) -> Result<Self, ExactCacheError>

Create a cache handle after validating the complete identity.

pub fn stable_path(&self) -> &Path

Stable caller-facing path used to locate this cache entry.

pub fn open_single_flight( &self, options: ExactCacheSingleFlightOptions, ) -> Result<ExactCacheOpen, ExactCacheError>

Open this cache with bounded single-flight miss coalescing.

A hit contains bytes verified by the unchanged schema-v3 commit protocol. Only the returned owner should perform acquisition.

pub fn lock( &self, timeout: Duration, ) -> Result<ExactCacheGuard, ExactCacheError>

Acquire the per-entry cross-process lock with bounded waiting.

pub fn read(&self) -> Result<Option<CommittedExactCacheEntry>, ExactCacheError>

Read and digest-verify the currently committed immutable entry.

Returns Ok(None) only when no commit marker exists. A malformed, incomplete, or mismatched entry is an error, never a cache miss.

pub fn publish( &self, guard: &ExactCacheGuard, product: &[u8], archive: &[u8], provenance: &[u8], ) -> Result<CommittedExactCacheEntry, ExactCacheError>

Publish a complete validated candidate under the held entry lock.

pub fn cleanup_abandoned( &self, guard: &ExactCacheGuard, ) -> Result<(), ExactCacheError>

Remove unreferenced transactions while holding the entry lock.

Trait Implementations

impl Clone for ExactProductCache

fn clone(&self) -> ExactProductCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExactProductCache

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

Formats the value using the given formatter.