Struct SnapshotRing 

pub struct SnapshotRing { /* private fields */ }

Bounded ring of IncrementalSnapshot values.

Newest snapshot at the back; the oldest is dropped when the ring fills (single-producer-single-consumer pattern — the freeze coordinator pushes, the failure-dump renderer drains).

Cheap to clone for sidecar persistence: Vec of Vec<u8> shares no internal state, so the capture-mode binary can snapshot the ring at trigger time without blocking the coordinator’s continued sampling.

Implementations

impl SnapshotRing

pub fn new(capacity: usize) -> Self

New ring with the requested capacity. Pass DEFAULT_SNAPSHOT_RING_DEPTH for the storage-budget-tuned default (60 entries).

pub fn push(&mut self, snap: IncrementalSnapshot)

Push a new snapshot. When the ring is full, the oldest entry is dropped (FIFO eviction).

pub fn len(&self) -> usize

Number of snapshots currently held.

pub fn is_empty(&self) -> bool

True when the ring holds no snapshots.

pub fn capacity(&self) -> usize

Capacity (the depth this ring was constructed with).

pub fn drain(&mut self) -> Vec<IncrementalSnapshot>

Drain every held snapshot into a vec, oldest-first. Used by the failure-dump renderer at trigger time to consume the pre-trigger window.

pub fn snapshots(&self) -> impl Iterator<Item = &IncrementalSnapshot>

Borrow the held snapshots for read-only inspection (e.g. the capture-mode binary’s “show me what’s in the ring right now” diagnostic).

Trait Implementations

impl Clone for SnapshotRing

fn clone(&self) -> SnapshotRing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SnapshotRing

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

Formats the value using the given formatter.

impl Default for SnapshotRing

fn default() -> SnapshotRing

Returns the “default value” for a type.