Struct FileHandler

pub struct FileHandler { /* private fields */ }

A handler that writes log records to a file.

Implementations

impl FileHandler

pub fn new<P: AsRef<Path>>(path: P) -> Result<Self>

Creates a new file handler that writes to the specified file.

Arguments

• path - The path to the log file
• level - The minimum log level to handle

Returns

A new FileHandler instance

Errors

Returns an error if the file cannot be opened or created

pub fn close(&mut self)

Closes the file handle if it’s open.

pub fn with_colors(self, use_colors: bool) -> Self

Sets whether to use colors in the output.

pub fn with_pattern(self, pattern: impl Into<String>) -> Self

Sets the format pattern to use.

pub fn path(&self) -> &str

Returns the path to the log file.

pub fn with_rotation(self, max_size: u64) -> Self

Sets the maximum file size before rotation

pub fn with_retention(self, retention: usize) -> Self

Sets the number of old files to keep

Trait Implementations

impl Debug for FileHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Handler for FileHandler

fn level(&self) -> LogLevel

Get the current log level

fn set_level(&mut self, level: LogLevel)

Set the log level

fn enabled(&self) -> bool

Check if the handler is enabled

fn set_enabled(&mut self, enabled: bool)

Enable or disable the handler

fn formatter(&self) -> &Formatter

Get the formatter

fn set_formatter(&mut self, formatter: Formatter)

Set the formatter

fn handle(&mut self, record: &Record) -> bool

Handle a log record