CerrWrite

Struct CerrWrite 

Source
pub struct CerrWrite { /* private fields */ }
Expand description

A factory for creating loggers that write directly to the standard error (stderr).

CerrWrite provides a high-level builder for console logging. This is the recommended choice for professional CLI applications, as it ensures that diagnostic information (logs) does not interfere with the primary data stream sent to stdout.

§Default Configuration

  • Max Retries: 3 (Resilience against transient I/O blocks or terminal pressure).
  • Worker Count: 1 (Ensures logs appear in strict chronological order).

Implementations§

Source§

impl CerrWrite

Source

pub fn get_max_retries(&self) -> usize

Returns the currently configured maximum retry attempts.

Source

pub fn get_worker_count(&self) -> usize

Returns the currently configured background worker count.

Source

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

Updates the maximum number of retry attempts for the stderr service.

Useful if the error stream is being redirected to a file or pipe that may experience intermittent congestion.

Source

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

Updates the background worker count for asynchronous error logging.

Note: Using a worker count of 1 is strongly advised for stderr to prevent terminal interleaving and preserve message order.

Source

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

Finalizes the logger using the StandardWriteMessageFormatter and a Concurrency strategy.

Source

pub fn build_with_formatter<MF>( self, concurrency: Concurrency, formatter: MF, ) -> Logger
where MF: WriteMessageFormatter + 'static,

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

This is frequently used to apply “error red” ANSI styling or specialized headers specifically for diagnostic output.

Source

pub fn build_impl_direct(self) -> Box<DirectLogger>

Builds the underlying DirectLogger implementation for stderr.

Source

pub fn build_impl_queued(self) -> Box<QueuedLogger>

Builds the underlying QueuedLogger implementation for stderr.

Source

pub fn build_impl_direct_with_formatter<MF>( self, formatter: MF, ) -> Box<DirectLogger>
where MF: WriteMessageFormatter + 'static,

Builds a DirectLogger with a specific formatter for stderr.

Source

pub fn build_impl_queued_with_formatter<MF>( self, formatter: MF, ) -> Box<QueuedLogger>
where MF: WriteMessageFormatter + 'static,

Builds a QueuedLogger with a specific formatter for stderr.

Source

pub fn build_service_with_formatter<MF>( self, formatter: MF, ) -> Box<CerrWrite<MF>>
where MF: WriteMessageFormatter + 'static,

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

Source

pub fn build_service(self) -> Box<CerrWrite<StandardWriteMessageFormatter>>

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

Trait Implementations§

Source§

impl Default for CerrWrite

Source§

fn default() -> Self

Provides sensible defaults for error console logging.

  • max_retries: 3
  • worker_count: 1 (Preserves sequential terminal output).

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more