Struct LogSpecBuilder

pub struct LogSpecBuilder { /* private fields */ }

Builder for LogSpecification.

Example

Start with a programmatically built log specification, and use the LoggerHandle to apply a modified version of the log specification at a later point in time:

use flexi_logger::{Logger, LogSpecification};
use log::LevelFilter;

fn main() {
    // Build the initial log specification
    let mut builder = LogSpecification::builder();
    builder
        .default(LevelFilter::Info)
        .module("karl", LevelFilter::Debug);

    // Initialize Logger, keep builder alive
    let mut logger = Logger::with(builder.build())
        // your logger configuration goes here, as usual
        .start()
        .unwrap_or_else(|e| panic!("Logger initialization failed with {}", e));

    // ...

    // Modify builder and update the logger
    builder
        .default(LevelFilter::Error)
        .remove("karl")
        .module("emma", LevelFilter::Trace);

    logger.set_new_spec(builder.build());

    // ...
}

Implementations

impl LogSpecBuilder

pub fn new() -> LogSpecBuilder

Creates a LogSpecBuilder with all logging turned off.

pub fn from_module_filters(module_filters: &[ModuleFilter]) -> LogSpecBuilder

Creates a LogSpecBuilder from given module filters.

pub fn default(&mut self, lf: LevelFilter) -> &mut LogSpecBuilder

Adds a default log level filter, or updates the default log level filter.

pub fn module<M>( &mut self, module_name: M, lf: LevelFilter, ) -> &mut LogSpecBuilder

where M: AsRef<str>,

Adds a log level filter, or updates the log level filter, for a module.

pub fn remove<M>(&mut self, module_name: M) -> &mut LogSpecBuilder

where M: AsRef<str>,

Adds a log level filter, or updates the log level filter, for a module.

pub fn insert_modules_from( &mut self, other: LogSpecification, ) -> &mut LogSpecBuilder

Adds log level filters from a LogSpecification.

pub fn finalize(self) -> LogSpecification

Creates a log specification without text filter.

pub fn build(&self) -> LogSpecification

Creates a log specification without being consumed.

Trait Implementations

impl Clone for LogSpecBuilder

fn clone(&self) -> LogSpecBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LogSpecBuilder

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

Formats the value using the given formatter.

impl Default for LogSpecBuilder

fn default() -> LogSpecBuilder

Returns the “default value” for a type.