Struct Session 

pub struct Session { /* private fields */ }

A session is a temporary logger that will print immediately but only write when dropped. All the logs during the session will be grouped together and write once. It’s useful when you want to log a series of messages such as one session of a request. The session is panic-safe, which means it will write all the logs when panic.

Apart from the formatter, the session can be Silent. If it’s silent, then the header & footer will not be printed or written if the session never logged anything. Due to the uncertainty of if the session will log anything, the header will be deferred until the first log. If the session logged anything, then it acts like a normal session.

Implementations

impl Session

pub fn session(&self, name: impl Into<String>, silent: bool) -> Self

Create a new session from the session.

This is useful when you want to create a sub-session from a session. The sub-session will later be nested under the parent session when written.

pub fn session_then<F, T>( &self, name: impl Into<String>, silent: bool, callable: F, ) -> T

where F: FnOnce(Self) -> T,

Create a new session from the session and execute the callable with the session passed in.

This can be handy for isolating the environment of each callable while also providing a common logging interface for any callable that needs to be logged.

Trait Implementations

impl Drop for Session

fn drop(&mut self)

Executes the destructor for this type.

impl Loggable for Session

fn root_name(&self) -> &str

Get the name of the root logger.

fn name(&self) -> &str

Get the name of current logger.

fn path(&self) -> String

Get the path of the log file.

fn write_level(&self) -> Level

Get the writing level of the root logger.

fn print_level(&self) -> Level

Get the printing level of the root logger.

fn verbose(&self, message: &str)

Log a message with verbose level.

fn debug(&self, message: &str)

Log a message with debug level.

fn info(&self, message: &str)

Log a message with info level.

fn warning(&self, message: &str)

Log a message with warning level.

fn critical(&self, message: &str)

Log a message with critical level.

fn error(&self, message: &str)

Log a message with error level.

fn fatal(&self, message: &str) -> !

Log a message with fatal level. The program will panic after logging the message.