multiline-logger 0.2.1

Personal logger implementation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

// SPDX-License-Identifier: MIT OR Apache-2.0
//! Common system abstractions
use std::io;
use std::path::Path;

use crate::{Header, Panic, Record};

/// functions required to be implemented by a platform
pub(crate) trait SystemImpl {
	type File;
	fn file_new(path: &'static Path) -> Self::File;
	fn file_p_header(this: &Self::File, message: &Header);
	fn file_p_record(this: &Self::File, message: &Record);
	fn file_p_panic(this: &Self::File, message: &Panic);
	fn file_flush(this: &Self::File);
	fn file_path(this: Option<&Self::File>) -> Option<&'static Path>;
	type Console;
	fn console_new() -> Self::Console;
	fn console_p_header(this: &Self::Console, message: &Header);
	fn console_p_record(this: &Self::Console, message: &Record);
	fn console_p_panic(this: &Self::Console, message: &Panic);
	fn console_flush(this: &Self::Console);
	fn fallback_p_panic(message: &Panic);
	#[cfg(feature = "backtrace")]
	type Backtrace;
	#[cfg(feature = "backtrace")]
	fn backtrace_new() -> Self::Backtrace;
	#[cfg(not(feature = "backtrace"))]
	fn backtrace_new() {}
	#[cfg(feature = "backtrace")]
	fn backtrace_write<W: io::Write>(trace: &Self::Backtrace, writer: W) -> io::Result<()>;
	#[cfg(not(feature = "backtrace"))]
	#[expect(clippy::trivially_copy_pass_by_ref, reason = "api symmetry")]
	fn backtrace_write<W>((): &(), _: W) -> io::Result<()> { Ok(()) }
	#[cfg(feature = "backtrace")]
	fn backtrace_string(trace: &Self::Backtrace) -> String;
	#[cfg(not(feature = "backtrace"))]
	#[expect(clippy::trivially_copy_pass_by_ref, reason = "api symmetry")]
	fn backtrace_string((): &()) -> String { String::new() }
}