Struct ExclusiveLockedRunStore 

pub struct ExclusiveLockedRunStore<'store> { /* private fields */ }

A run store that has been locked for exclusive access.

The lifetime parameter ensures this isn’t held for longer than the corresponding RunStore.

Implementations

impl<'store> ExclusiveLockedRunStore<'store>

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

Returns the runs directory.

pub fn write_permission(&self) -> RunsJsonWritePermission

Returns whether this nextest can write to the runs.json.zst file.

If the file has a newer format version than we support, writing is denied.

pub fn complete_run( &mut self, run_id: ReportUuid, sizes: StoreSizes, status: RecordedRunStatus, duration_secs: Option<f64>, ) -> Result<bool, RunStoreError>

Marks a run as completed and persists the change to disk.

Updates sizes, status, and duration_secs to the given values. Returns true if the run was found and updated, false if no run with the given ID exists (in which case nothing is persisted).

Returns an error if writing is denied due to a format version mismatch.

The status should not be Incomplete since we’re completing the run.

pub fn prune( &mut self, policy: &RecordRetentionPolicy, kind: PruneKind, ) -> Result<PruneResult, RunStoreError>

Prunes runs according to the given retention policy.

This method:

1. Determines which runs to delete based on the policy
2. Deletes those run directories from disk
3. Deletes any orphaned directories not tracked in runs.json.zst
4. Updates the run list in memory and on disk

The kind parameter indicates whether this is explicit pruning (from a user command) or implicit pruning (automatic during recording). This affects how errors are displayed.

Returns the result of the pruning operation, including any errors that occurred while deleting individual runs.

Returns an error if writing is denied due to a format version mismatch.

pub fn prune_if_needed( &mut self, policy: &RecordRetentionPolicy, ) -> Result<Option<PruneResult>, RunStoreError>

Prunes runs if needed, based on time since last prune and limit thresholds.

This method implements implicit pruning, which occurs:

• If more than 1 day has passed since the last prune, OR
• If any retention limit is exceeded by 1.5x.

Use Self::prune for explicit pruning that always runs regardless of these conditions.

Returns Ok(None) if pruning was skipped, Ok(Some(result)) if pruning occurred.

Trait Implementations

impl<'store> Debug for ExclusiveLockedRunStore<'store>

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

Formats the value using the given formatter.