Struct IoWrite 

pub struct IoWrite { /* private fields */ }

A specialized factory for creating loggers that write to byte-oriented destinations.

The IoFactory acts as the entry point for any output that implements std::io::Write. It allows you to configure global retry and threading policies before selecting a specific output target (like a File or a Buffered Writer).

Default Configuration

• Max Retries: 3 (Attempts to re-send if a write failure occurs).
• Worker Count: 1 (Single background thread to maintain message order).

Implementations

impl IoWrite

pub fn file(self, file: File) -> FileIoFactory

Specializes the factory to log directly to a filesystem File.

This is the most direct path for file logging. Each log entry is dispatched immediately to the OS file handle.

pub fn buffered_file(self, file: BufWriter<File>) -> BufferedFileIoFactory

Specializes the factory to log to a BufWriter<File>.

Performance Choice: By batching small writes into a memory buffer, this reduces the frequency of expensive system calls. Highly recommended for high-throughput applications.

pub fn boxed(self, writer: Box<dyn Write + Send + Sync>) -> BoxedIoFactory

Specializes the factory for a boxed Write trait object.

Useful when the concrete writer type is erased or determined at runtime.

pub fn writer<W>(self, writer: W) -> TypedIoWrite<W>

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

Specializes the factory for any generic type implementing std::io::Write.

pub fn max_retries(self, max_retries: usize) -> Self

Configures the maximum number of retries for the resulting service.

pub fn worker_count(self, worker_count: usize) -> Self

Configures the background worker thread count for asynchronous logging.

pub fn build<W>(self, concurrency: Concurrency, writer: W) -> Logger

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

Finalizes the logger using a specific writer and a Concurrency strategy. This uses the default StandardWriteMessageFormatter.

pub fn build_impl_direct<W>(self, writer: W) -> Box<DirectLogger>

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

Builds a DirectLogger implementation wrapped in a Box.

pub fn build_impl_queued<W>(self, writer: W) -> Box<QueuedLogger>

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

Builds a QueuedLogger implementation wrapped in a Box.

pub fn build_service<W>( self, writer: W, ) -> Box<IoWrite<W, StandardWriteMessageFormatter>>

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

Internal helper to construct the service::IoWrite service with the standard formatter.

pub fn build_with_formatter<W, MF>( self, concurrency: Concurrency, writer: W, formatter: MF, ) -> Logger

where MF: WriteMessageFormatter + 'static, W: Write + Send + Sync + 'static,

Finalizes the logger using a custom formatter and a Concurrency strategy.

pub fn build_impl_direct_with_formatter<W, MF>( self, writer: W, formatter: MF, ) -> Box<DirectLogger>

where MF: WriteMessageFormatter + 'static, W: Write + Send + Sync + 'static,

Builds a DirectLogger with a custom formatter.

pub fn build_impl_queued_with_formatter<W, MF>( self, writer: W, formatter: MF, ) -> Box<QueuedLogger>

where MF: WriteMessageFormatter + 'static, W: Write + Send + Sync + 'static,

Builds a QueuedLogger with a custom formatter.

pub fn build_service_with_formatter<W, MF>( self, writer: W, formatter: MF, ) -> Box<IoWrite<W, MF>>

where MF: WriteMessageFormatter + 'static, W: Write + Send + Sync + 'static,

Internal helper to construct the service::IoWrite service with a custom formatter.

Trait Implementations

impl Default for IoWrite

fn default() -> Self

Provides sensible defaults for byte-oriented logging.

• max_retries: 3 (Standard resilience against transient I/O issues).
• worker_count: 1 (Ensures sequential log ordering in asynchronous mode).