Struct ClientRingBuffer 

pub struct ClientRingBuffer { /* private fields */ }

Per-client debug ring buffer.

A fixed-capacity (8 KB default) ring buffer that captures client-specific events for debugging. When the buffer is full, oldest entries are discarded.

Thread Safety

All operations are thread-safe. Multiple readers can access the buffer simultaneously; writers are exclusive.

Implementations

impl ClientRingBuffer

pub fn new() -> Self

Creates a new ring buffer with default capacity (8 KB).

pub fn with_capacity(capacity_bytes: usize) -> Self

Creates a new ring buffer with the specified capacity in bytes.

pub fn log_event(&self, event_type: ClientEventType, details: impl Into<String>)

Logs an event to the buffer.

If the buffer would exceed capacity, oldest entries are discarded.

pub fn log_key(&self, key: &str)

Logs a key press event.

pub fn log_command(&self, command: &str)

Logs a command execution event.

pub fn log_mode_change(&self, from: &str, to: &str)

Logs a mode change event.

pub fn log_state_change(&self, description: &str)

Logs a state change event.

pub fn log_error(&self, error: &str)

Logs an error event.

pub fn tail(&self, n: usize) -> Vec<ClientLogEntry>

Returns the N most recent entries (newest first).

pub fn entries(&self) -> Vec<ClientLogEntry>

Returns all entries in order (oldest to newest).

pub fn dump(&self) -> String

Formats all entries as a string for crash dumps.

Blocks until the lock is acquired.

pub fn try_dump(&self) -> Option<String>

Attempts to format all entries without blocking.

Returns None if the lock cannot be acquired immediately. Use this in panic handlers to avoid deadlocks.

pub fn stats(&self) -> ClientBufferStats

Returns buffer statistics.

pub fn bytes_used(&self) -> usize

Returns the current byte usage.

pub fn clear(&self)

Clears all entries from the buffer.

Trait Implementations

impl Clone for ClientRingBuffer

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientRingBuffer

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

Formats the value using the given formatter.

impl Default for ClientRingBuffer

fn default() -> Self

Returns the “default value” for a type.