Struct Builder 

pub struct Builder {
    pub dynamic: bool,
    pub rotation_signals: Vec<i32>,
    pub panic: bool,
    pub continue_when_panic: bool,
    pub sinks: Vec<Box<dyn SinkConfigTrait>>,
    pub tracing_global: bool,
}

Global config to setup logger See crate::recipe for usage

Fields

dynamic: bool

When dynamic==true, Can safely re-initialize GlobalLogger even it exists, useful to setup different types of logger in test suits. When dynamic==false, Only initialize once, logger sinks setting cannot be change afterwards. More efficient for production environment.

rotation_signals: Vec<i32>

Listen for signal of log-rotate NOTE: Once logger started to listen signal, does not support dynamic reconfigure.

panic: bool

Hookup to log error when panic

continue_when_panic: bool

Whether to exit program after panic

sinks: Vec<Box<dyn SinkConfigTrait>>

Different types of log sink

tracing_global: bool

Available on crate feature tracing only.

subscribe to tracing as global dispatcher

Implementations

impl Builder

pub fn new() -> Self

pub fn tracing_global(self) -> Self

Available on crate feature tracing only.

subscribe to tracing as global dispatcher

pub fn test(self) -> Self

For test cases, set dynamic=true and turn Off signal. Call this with pre-set recipe for convenient.

pub fn signal(self, signal: i32) -> Self

Add log-rotate signal

pub fn add_sink<S: SinkConfigTrait>(self, config: S) -> Self

Add different types of log sink config, can be called multiple times.

pub fn get_max_level(&self) -> LevelFilter

Return the max log level in the log sinks

pub fn build(self) -> Result<&'static GlobalLogger>

Setup global logger. Equals to setup_log(builder)

NOTE: You can call this function multiple times when builder.dynamic=true, but cannot mixed used captains_log with other logger implement, because log::set_logger() cannot be called twice.

Trait Implementations

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.