CoutWrite

Struct CoutWrite 

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

A factory for creating loggers that write directly to the standard output (stdout).

CoutWrite provides a high-level builder for console logging. It is the most common choice for CLI applications and containerized environments (like Docker or K8s) where logs are expected to be captured from the process’s stdout stream.

§Default Configuration

  • Max Retries: 3 (Standard resilience against transient I/O pressure).
  • Worker Count: 1 (Ensures logs appear in chronological order).

Implementations§

Source§

impl CoutWrite

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 console service.

This is useful if the terminal or pipe is under heavy load and requires multiple attempts to flush data.

Source

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

Updates the background worker count for asynchronous console logging.

Note: Using a worker count of 1 is highly recommended for console output to prevent log lines from overlapping or appearing out of 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.

Use this to apply custom styling, colors, or structured formats (like JSON) to the console output.

Source

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

Builds the underlying DirectLogger implementation for stdout.

Source

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

Builds the underlying QueuedLogger implementation for stdout.

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.

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.

Source

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

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

Source

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

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

Trait Implementations§

Source§

impl Default for CoutWrite

Source§

fn default() -> Self

Provides sensible defaults for 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