Struct flexi_logger::LogConfig

pub struct LogConfig {
    pub format: fn(_: &Record) -> String,
    pub log_to_file: bool,
    pub print_message: bool,
    pub duplicate_error: bool,
    pub duplicate_info: bool,
    pub directory: Option<String>,
    pub suffix: Option<String>,
    pub timestamp: bool,
    pub rotate_over_size: Option<usize>,
    pub discriminant: Option<String>,
    pub create_symlink: Option<String>,
}

Internal struct for influencing the behavior of flexi_logger.

You only need to use this structure explicitly if you want to instantiate multiple loggers in a process.

Fields

format: fn(_: &Record) -> String

Defines the logline format. You can either choose between some predefined variants, default_format, opt_format, detailed_format, with_thread, or you create and use your own format function with the signature fn(&Record) -> String.

log_to_file: bool

• If false, the log is written to stderr.
• If true, a new file is created and the log is written to it.

The default pattern for the filename is '<program_name>_<date>_<time>.<suffix>', e.g. myprog_2015-07-08_10-44-11.log.

Note that all following members are only relevant if this one is set to true.

print_message: bool

If true, the name of the logfile is documented in a message to stdout.

duplicate_error: bool

If true, all logged error messages are duplicated to stdout.

duplicate_info: bool

If true, all logged warning and info messages are also duplicated to stdout.

directory: Option<String>

Allows specifying a directory in which the log files are created.

suffix: Option<String>

Allows specifying the filesystem suffix of the log files (without the dot).

timestamp: bool

Allows specifying whether or not the filename should include a timestamp.

rotate_over_size: Option<usize>

Allows specifying a maximum size for log files in bytes; when the specified file size is reached or exceeded, the file will be closed and a new one will be opened. The filename pattern changes - instead of the timestamp, the serial number is included into the filename.

discriminant: Option<String>

Allows specifying an additional part of the log file name that is inserted after the program name.

create_symlink: Option<String>

Allows specifying an option to create a symlink to the most recent log file created using the given name.

Note that this option is only effective on linux systems.

Methods

impl LogConfig

fn default_config_for_logger() -> LogConfig

Default configuration used by Logger.

• log_to_file: false
• print_message: false
• duplicate_error: false
• duplicate_info: false
• format: flexi_logger::default_format
• no directory: log files (if used) are created where the program was started
• no rotate_over: log file (if used) grows indefinitely
• the name of the log file (if used) consists of progname, timestamp, and suffix log
• no symlink is created

fn new() -> LogConfig

Default configuration used by LogOptions.

• log_to_file: false
• print_message: true
• duplicate_error: true
• duplicate_info: false
• format: flexi_logger::default_format
• no directory: log files (if used) are created where the program was started
• no rotate_over: log file (if used) grows indefinitely
• the name of the log file (if used) consists of progname, timestamp, and suffix log
• no symlink is created

Trait Implementations

impl Default for LogConfig

fn default() -> Self

Returns the "default value" for a type.