Struct RunStore 

pub struct RunStore { /* private fields */ }

Manages the storage of recorded test runs.

The run store is a directory containing a list of recorded runs and their data. Use RunStore::lock_exclusive to acquire exclusive access before creating new runs.

Implementations

impl RunStore

pub fn new(store_dir: &Utf8Path) -> Result<Self, RunStoreError>

Creates a new RunStore at the given directory.

Creates the directory if it doesn’t exist.

pub fn runs_dir(&self) -> StoreRunsDir<'_>

Returns the runs directory.

pub fn lock_shared(&self) -> Result<SharedLockedRunStore<'_>, RunStoreError>

Acquires a shared lock on the run store for reading.

Multiple readers can hold the shared lock simultaneously, but the shared lock is exclusive with the exclusive lock (used for writing).

Uses non-blocking lock attempts with retries to handle both brief contention and filesystems where locking may not work (e.g., NFS).

pub fn lock_exclusive( &self, ) -> Result<ExclusiveLockedRunStore<'_>, RunStoreError>

Acquires an exclusive lock on the run store.

This lock should only be held for a short duration (just long enough to add a run to the list and create its directory).

Uses non-blocking lock attempts with retries to handle both brief contention and filesystems where locking may not work (e.g., NFS).

Trait Implementations

impl Debug for RunStore

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

Formats the value using the given formatter.