Struct IoWrite 

pub struct IoWrite<W, F>
where
    W: Write + Send + Sync,
    F: MessageFormatter,
{ /* private fields */ }

A thread-safe Service for byte-stream logging destinations.

IoWrite is the primary workhorse for file-based, socket-based, or console-based logging. It implements the Service trait by wrapping its internal data in a Mutex.

Performance Note

This service does not explicitly call flush() after every write. If low-latency is required with guaranteed persistence, wrap your writer in std::io::BufWriter.

Implementations

impl<W, F> IoWrite<W, F>

where W: Write + Send + Sync, F: MessageFormatter,

pub fn new(writer: W) -> Box<Self>

Creates a new IoWrite on the heap.

Parameters

• writer: A type implementing std::io::Write.
• formatter: The MessageFormatter implementation.

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

Creates a new IoWrite on the heap with a custom formatter.

Parameters

• writer: A type implementing std::io::Write.
• formatter: The MessageFormatter implementation.

Trait Implementations

impl<W, F> Fallback for IoWrite<W, F>

where W: Write + Send + Sync + 'static, F: MessageFormatter + 'static,

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

Best-effort fallback. Skips writing if the mutex is locked or poisoned to prevent cascading failures in the logging pipeline.

impl<W, F> Service for IoWrite<W, F>

where W: Write + Send + Sync + 'static, F: MessageFormatter + 'static,

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

Acquires the lock and streams the formatted message to the writer.

Errors

• ServiceError::LockPoisoned: If the internal Mutex is poisoned.
• ServiceError: If the formatter fails or the writer encounters an I/O error.

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.