Struct ConfiguredWarmStartStore 

pub struct ConfiguredWarmStartStore { /* private fields */ }

A best-effort warm-start store rooted at an explicit caller-owned path.

Persistence is an optimization, so an unavailable filesystem never makes a fit fail. The first attempted use opens the exact configured root and records either the store or its permanent absence for this fit. Every clone observes that same decision, preventing repeated directory scans and repeated diagnostics.

Implementations

impl ConfiguredWarmStartStore

pub fn new(root: PathBuf, options: StoreOptions) -> Self

Configure a store without touching the filesystem.

pub fn root(&self) -> &Path

The exact root supplied by the caller. No canonicalization, joining, or environment-dependent relocation is performed.

pub fn store(&self) -> Option<&WarmStartStore>

Return the shared opened store, or None when persistence is unavailable.

This is the sole owner of the open-failure decision and diagnostic. Failures are memoized: a fit proceeds cold and never repeatedly probes a root that already refused the configured store.

pub fn open_session(&self, key: Fingerprint) -> Option<Arc<Session>>

Open a keyed session governed by this capability’s shared availability decision.

Session reads and writes report filesystem refusal back to this owner, so one failed outer-iterate checkpoint disables every record, artifact, and session operation belonging to the fit.

pub fn mark_unavailable(&self, operation: &str, error: &dyn Display)

Permanently disable this fit’s configured persistence after the filesystem refuses an operation.

The first refusal owns the sole diagnostic; subsequent loads/stores and every clone become cold no-ops. Callers should use this only for environmental I/O failures, not serialization or contract defects.

Trait Implementations

impl Clone for ConfiguredWarmStartStore

fn clone(&self) -> ConfiguredWarmStartStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfiguredWarmStartStore

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

Formats the value using the given formatter.