Struct flexi_logger::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() -> Self

Creates a LogSpecBuilder with all logging turned off.

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

Creates a LogSpecBuilder from given module filters.

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

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

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

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

pub fn remove<M: AsRef<str>>(&mut self, module_name: M) -> &mut Self

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

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

Adds log level filters from a LogSpecification.

pub fn finalize(self) -> LogSpecification

Creates a log specification without text filter.

pub fn finalize_with_textfilter(self, tf: Regex) -> LogSpecification

Creates a log specification with text filter.

This method is only avaible if the dafault feature textfilter is not switched off.

pub fn build(&self) -> LogSpecification

Creates a log specification without being consumed.

pub fn build_with_textfilter(&self, tf: Option<Regex>) -> LogSpecification

Creates a log specification without being consumed, optionally with a text filter.

This method is only avaible if the dafault feature textfilter is not switched off.

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

Formats the value using the given formatter.

impl Default for LogSpecBuilder

fn default() -> LogSpecBuilder

Returns the “default value” for a type.