Struct FStdoutLogger 

pub struct FStdoutLogger { /* private fields */ }

The main logger implementation that outputs to stdout and optionally to a file.

This struct implements the Log trait from the standard log crate, handling log messages by:

1. Writing to stdout with optional colors and formatting
2. Writing to a file (if configured) with full details

Example

use fstdout_logger::{FStdoutLogger, LoggerConfig};
use log::LevelFilter;

// Creating a logger directly (usually done via helper functions)
let logger = FStdoutLogger::with_config(
    Some("app.log"),
    LoggerConfig::default()
).expect("Failed to create logger");

// Initialize as the global logger
logger.init_with_level(LevelFilter::Info).expect("Failed to initialize logger");

Implementations

impl FStdoutLogger

pub fn new<P: AsRef<Path>>(file_path: Option<P>) -> Result<Self, LogError>

Create a new logger with default configuration.

This is a convenience method that uses LoggerConfig::default().

Arguments

• file_path - Optional path to a log file. If None, logs will only go to stdout.

Returns

A new logger instance or an error if the log file couldn’t be opened.

pub fn with_config<P: AsRef<Path>>( file_path: Option<P>, config: LoggerConfig, ) -> Result<Self, LogError>

Create a new logger with custom configuration.

Arguments

• file_path - Optional path to a log file. If None, logs will only go to stdout.
• config - Configuration options for the logger.

Returns

A new logger instance or an error if the log file couldn’t be opened.

pub fn init(self) -> Result<(), LogError>

Initialize the logger with the default configuration.

This sets the maximum log level to Trace to enable all logs, but actual filtering will happen according to the level setting in the logger’s configuration.

Returns

Ok(()) if initialization succeeded, or an error if it failed.

pub fn init_with_level(self, level: LevelFilter) -> Result<(), LogError>

Initialize the logger with a specific log level.

This sets the global maximum log level, overriding the level in the logger’s configuration.

Arguments

• level - The minimum log level to display.

Returns

Ok(()) if initialization succeeded, or an error if it failed.

Trait Implementations

impl Log for FStdoutLogger

Implementation of the Log trait for FStdoutLogger.

This handles:

• Checking if a log message should be processed (with module-level filtering)
• Formatting messages differently for stdout and file
• Writing to both destinations
• Flushing output streams

fn enabled(&self, metadata: &Metadata<'_>) -> bool

Determines if a log message with the specified metadata would be logged.

fn log(&self, record: &Record<'_>)

Logs the Record.

fn flush(&self)

Flushes any buffered records.