Struct Logger 

pub struct Logger { /* private fields */ }

A thread-safe, high-level wrapper around a logging implementation.

Logger acts as the primary entry point for the application. It uses an Arc internally to allow cheap cloning and safe sharing across asynchronous tasks or threads.

Loggers can be easily built using LoggerFactory.

Because it uses an Arc internally, cloning a Logger is extremely cheap— it only increments a reference count. This allows you to pass the logger into multiple threads, closures, or asynchronous tasks easily.

Implementations

impl Logger

pub fn new(implementation: Box<dyn LoggerImpl + Send + Sync>) -> Logger

Creates a new Logger instance with the specified backend implementation.

Example

let logger = Logger::new(SilentLogger::new());

pub fn status(&self) -> LoggerStatus

Returns the current LoggerStatus of the underlying logging backend.

This provides a quick check to see if the logging service is Running or has become Broken (e.g., due to a disk failure or network disconnection).

pub fn log<T: Loggable>(&self, message: T) -> &Logger

Logs an entry that implements the Loggable trait.

This method uses static dispatch (monomorphization) to resolve the input T into a Message before passing it to the internal implementation.

The enumeration LogLevel implements Display and can be used as levels.

Returns

Returns a reference to self to enable Method Chaining (Fluent API).

Example

logger.log((LogLevel::Info, "Step 1"))
      .log((LogLevel::Info, "Step 2"));

Arguments

• message - Anything that can be converted into a log message, typically a tuple such as (Level::Info, "Hello World").

pub fn get_implementation(&self) -> &dyn LoggerImpl

Provides access to the underlying LoggerImpl.

This is useful for accessing backend-specific methods or performing downcasts via Any.

pub fn take_implementation(self) -> Arc<dyn LoggerImpl>

Destroys the logger and returns the underlying LoggerImpl.

Another logger may be using this implementation elsewhere.

This is useful for accessing backend-specific methods or performing downcasts via Any.

Trait Implementations

impl Clone for Logger

fn clone(&self) -> Logger

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.