Struct Settings

pub struct Settings {
    pub title: &'static str,
    pub filters: &'static [(&'static str, LevelFilter)],
    pub file_out: Option<&'static Path>,
    pub console_out: bool,
    pub panic_hook: Option<fn(Panic<'_>)>,
}

Settings for the logger

Fields

title: &'static str

A human-readable name for the application

filters: &'static [(&'static str, LevelFilter)]

List of module-prefix filters to match against, earlier filters get priority

file_out: Option<&'static Path>

Optional file path to output to (desktop only)

console_out: bool

Set to true to output to an appropriate console

panic_hook: Option<fn(Panic<'_>)>

Enables the formatted panic hook, and calls the supplied function. Use |_| () if you don’t have anything to run

Implementations

impl Settings

pub fn init(self)

Initializes the logger

Panics

will panic if initialization fails in any way

Examples found in repository

examples/demo.rs (line 22)

fn main() {
	multiline_logger::Settings {
		title: "logger test",
		filters: &[("", LevelFilter::Trace)],
		file_out: Some(Path::new("target/test.log")),
		console_out: true,
		#[expect(clippy::print_stdout, reason = "demo")]
		panic_hook: Some(|info| {
			println!(
				"Custom panic handler\nPanic info: {info:?}\nBacktrace: {:?}",
				info.trace.as_string()
			);
		}),
	}
	.init();
	log::trace!("Trace\n");
	log::debug!("Debug\n{:?}", [1, 2, 3, 4]);
	log::info!("Info: {}", 7);
	log::warn!("Warn {:#?}", [0, 9, 8, 7]);
	log::error!("Error");
	panic!("Panic Message");
}