Struct LogManager 

pub struct LogManager { /* private fields */ }

LogManager acts as a registry and dispatcher for multiple logging channels.

It maintains a default_logger for general use and a HashMap of specialized channels, using a high-performance FNV hasher for fast lookups.

Key Features

• Default Channel: The default channels is always set. By default, an implementation of crate::SilentLogger.
• Channel Routing: Dispatch logs to specific destinations via string identifiers.
• Fluent Interface: Methods like log() return &Self to allow for chaining.
• FVN-1 Hash: Uses FVN-1 hash to store the logs. Be careful about collisions!

Implementations

impl LogManager

pub fn new() -> Self

Creates a new LogManager with a SilentLogger implementation as the default. Logs sent to a new manager will be discarded until a default is set.

pub fn new_default(default_logger: Logger) -> Self

Creates a manager with a pre-configured default Logger.

pub fn get_logger<Q>(&self, channel: &Q) -> Option<Logger>

where Q: AsRef<str> + ?Sized,

Retrieves a Logger for a specific channel.

If the channel name is "default", it returns the default Logger. Returns None if the requested channel has not been registered.

Arguments

• channel - A string slice or type that can be referenced as a string.

pub fn set_logger<S>(&mut self, channel: S, logger: Logger)

where S: Into<String>,

Registers or updates a Logger for a specific channel name.

Using the name "default" will overwrite the default_logger.

pub fn remove_logger<Q>(&mut self, channel: &Q) -> Option<Logger>

where Q: AsRef<str> + ?Sized,

Registers or updates a Logger for a specific channel name.

Using the name "default" will do nothing and return None.

pub fn get_default_logger(&self) -> Logger

Returns a cloned instance of the current primary (default) Logger.

pub fn set_default_logger(&mut self, default_logger: Logger)

Directly updates the default Logger, bypassing the channel map.

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

Dispatches a message to the default Logger.

Example

let log_manager = LogManager::new();
log_manager.log(("INFO","System started"))
    .log((LogLevel::Info,"Initializing..."));

pub fn log_channel<Q, L>(&self, channel: &Q, message: L) -> &Self

where Q: AsRef<str> + ?Sized, L: Loggable,

Dispatches a message to a specific named channel.

Warning: If the channel does not exist, the log will be silently dropped. Use get_logger() beforehand if you need to guarantee delivery.

Example

let log_manager = LogManager::new();
log_manager.log_channel("default", ("INFO","System started"))
    .log_channel("default", (LogLevel::Info,"Initializing..."));