Struct LogRawFile 

pub struct LogRawFile {
    pub level: Level,
    pub format: LogFormat,
    pub file_path: Box<Path>,
}

Config for file sink that supports atomic append from multiprocess.

Used when you want a reliable log regardless of crash or killed. For log rotation, you need system log-rotate service to notify with signal.

Example

Source of crate::recipe::raw_file_logger_custom()

use captains_log::*;
use std::path::{self, Path, PathBuf};

pub fn raw_file_logger_custom<P: Into<PathBuf>>(
    file_path: P, max_level: Level, time_fmt: &'static str, format_func: FormatFunc,
) -> Builder {
    let format = LogFormat::new(time_fmt, format_func);
    let _file_path = file_path.into();
    let p = path::absolute(&_file_path).expect("path convert to absolute");
    let dir = p.parent().unwrap();
    let file_name = Path::new(p.file_name().unwrap());
    let file = LogRawFile::new(dir, file_name, max_level, format);
    return Builder::default().signal(signal_hook::consts::SIGUSR1).add_sink(file);
}

Fields

level: Level

max log level in this file

format: LogFormat

file_path: Box<Path>

path: dir/name

Implementations

impl LogRawFile

pub fn new<P1, P2>( dir: P1, file_name: P2, level: Level, format: LogFormat, ) -> Self

where P1: Into<PathBuf>, P2: Into<PathBuf>,

Construct config for file sink, will try to create dir if not exists.

The type of dir and file_name can be &str / String / &OsStr / OsString / Path / PathBuf. They can be of different types.

Trait Implementations

impl Hash for LogRawFile

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl SinkConfigTrait for LogRawFile

fn get_level(&self) -> Level

get max log level of the sink

fn get_file_path(&self) -> Option<Box<Path>>

Only file sink has path

fn write_hash(&self, hasher: &mut Box<dyn Hasher>)

Calculate hash for config comparison