Struct LoggerBuilder 

pub struct LoggerBuilder { /* private fields */ }

A builder for configuring log dispatching and setting up the global logger.

Examples

use logforth_core::append;

logforth_core::builder()
    .dispatch(|d| d.append(append::Stdout::default()))
    .apply();

Implementations

impl LoggerBuilder

pub fn dispatch<F>(self, f: F) -> Self

where F: FnOnce(DispatchBuilder<false>) -> DispatchBuilder<true>,

Register a new dispatch with the LoggerBuilder.

Examples

use logforth_core::append;

logforth_core::builder()
    .dispatch(|d| d.append(append::Stderr::default()))
    .apply();

pub fn build(self) -> Logger

Build the Logger.

Examples

let l = logforth_core::builder().build();
log::error!(logger: l, "Hello error!");

pub fn try_apply(self) -> Result<(), Logger>

Set up the global logger with all the configured dispatches.

This should be called early in the execution of a Rust program. Any log events that occur before initialization will be ignored.

Errors

Return an error if a global logger has already been set.

Examples

if logforth_core::builder().try_apply().is_err() {
    eprintln!("failed to set logger");
}

pub fn apply(self)

Set up the global logger with all the configured dispatches.

This should be called early in the execution of a Rust program. Any log events that occur before initialization will be ignored.

This function will panic if it is called more than once, or if another library has already initialized a global logger.

Panics

Panic if the global logger has already been set.

Examples

logforth_core::builder().apply();

Trait Implementations

impl Debug for LoggerBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.