Struct Cout 

pub struct Cout<F>
where
    F: MessageFormatter,
{ /* private fields */ }

A logging Service that targets the standard output stream (std::io::stdout).

Unlike other Services, Cout service does not own its writer. Instead, it acquires a handle to the global process stdout during every work call.

Why the Mutex?

Even though stdout is globally available, the MessageFormatter (field formatter) may hold internal state (like line counters or timing data) that is not thread-safe. Wrapping the formatter in a Mutex ensures that the formatting logic remains atomic and synchronized across threads.

Implementations

impl<F> Cout<F>

where F: MessageFormatter,

pub fn new() -> Box<Self>

Creates a new Cout service on the heap.

pub fn with_formatter(formatter: F) -> Box<Self>

Creates a new Cout service on the heap with a custom formatter.

Trait Implementations

impl<F> Fallback for Cout<F>

where F: MessageFormatter + 'static,

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

Emergency fallback that attempts to log the error back to stdout. If the formatter is locked or poisoned, the fallback is aborted to avoid deadlocks.

impl<F> Service for Cout<F>

where F: MessageFormatter + 'static,

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

Acquires the formatter lock and streams the formatted message to stdout.

This method locks the global stdout stream for the duration of the formatting process. This prevents “line interleaving” where parts of different log messages appear mixed in the console.

Errors

Returns ServiceError::LockPoisoned if the internal formatter mutex is poisoned.

fn status(&self) -> LoggerStatus

Returns the current operational [LoggerStatus] of the service.

fn as_any(&self) -> &dyn Any

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