Struct Vector 

pub struct Vector { /* private fields */ }

A logging Service that collects log entries into an in-memory Vec.

This service is primarily used for integration testing or UI feedback loops, allowing you to capture every log generated by a specific operation and inspect them programmatically afterward.

Thread Safety

The internal vector is protected by a Mutex. Multiple worker threads can push logs concurrently without data races or interleaving.

Implementations

impl Vector

pub fn new(capacity: usize) -> Box<Self>

Creates a new Vector service on the heap with a pre-allocated capacity.

Parameters

• capacity: The initial number of messages the vector can hold without reallocating.

pub fn inspect_vector<R>( &self, f: impl FnOnce(&Vec<VectorMessage>) -> R, ) -> Option<R>

Allows safe, read-only access to the captured logs without consuming the service.

This is useful for “heartbeat” checks or assertions in tests while the logger is still active.

Returns

• Some(R): The result of the closure f.
• None: If the internal lock was poisoned.

pub fn recover_vector(self) -> Result<Vec<VectorMessage>, ServiceError>

Consumes the service and returns all captured log messages.

This is the most efficient way to retrieve logs for final assertions or post-processing, as it extracts the data from the mutex.

Errors

Returns ServiceError::LockPoisoned if a thread panicked while holding the lock.

Trait Implementations

impl Fallback for Vector

fn fallback(&self, error: &ServiceError, msg: &Message)

Attempts to log an error to stdout if the primary work call fails.

This method performs a best-effort write. If the mutex is locked by a hanging thread, the fallback will be skipped to avoid a deadlock.

impl Service for Vector

fn status(&self) -> LoggerStatus

Returns LoggerStatus::Running.

fn work(&self, msg: &Message) -> Result<(), ServiceError>

Transforms the Message into a VectorMessage and pushes it onto the internal stack.

Errors

Returns ServiceError::LockPoisoned if the internal mutex is unreachable.

fn as_any(&self) -> &dyn Any

Returns a reference to the underlying type as Any for downcasting.