Struct flexi_logger::ReconfigurationHandle

pub struct ReconfigurationHandle { /* fields omitted */ }

Allows reconfiguring the logger programmatically.

Example

Obtain the ReconfigurationHandle (using .start()):

let mut log_handle = Logger::with_str("info")
    // ... your logger configuration goes here, as usual
    .start()
    .unwrap_or_else(|e| panic!("Logger initialization failed with {}", e));

// ...

You can permanently exchange the log specification programmatically, anywhere in your code:

// ...
log_handle.parse_new_spec("warn");
// ...

However, when debugging, you often want to modify the log spec only temporarily, for
one or few method calls only; this is easier done with the following method, because it allows switching back to the previous spec:

log_handle.parse_and_push_temp_spec("trace");
// ...
// critical calls
// ...

log_handle.pop_temp_spec();
// Continue with the log spec you had before.
// ...

Methods

impl ReconfigurationHandle

pub fn set_new_spec(&mut self, new_spec: LogSpecification)

Allows specifying a new LogSpecification for the current logger.

pub fn parse_new_spec(&mut self, spec: &str)

Allows specifying a new LogSpecification for the current logger.

pub fn push_temp_spec(&mut self, new_spec: LogSpecification)

Allows temporarily pushing a new LogSpecification for the current logger.

pub fn parse_and_push_temp_spec(&mut self, new_spec: &str)

Allows temporarily pushing a new LogSpecification for the current logger.

pub fn pop_temp_spec(&mut self)

Allows pushing a new LogSpecification for the current logger. It will automatically be popped once the returned guard is dropped.