flexi_logger 0.31.9

An easy-to-configure and flexible logger that writes logs to stderr or stdout and/or to files. It allows custom logline formats, and it allows changing the log specification at runtime. It also allows defining additional log streams, e.g. for alert or security messages.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

use crate::{FileSpec, WriteMode};
use std::path::PathBuf;

/// Configuration of a `FileLogWriter`.
#[derive(Debug, Clone)]
pub struct FileLogWriterConfig {
    pub(crate) print_message: bool,
    pub(crate) append: bool,
    pub(crate) write_mode: WriteMode,
    pub(crate) file_spec: FileSpec,
    pub(crate) o_create_symlink: Option<PathBuf>,
    pub(crate) line_ending: &'static [u8],
    pub(crate) use_utc: bool,
}

impl FileLogWriterConfig {
    /// Returns the configured directory.
    #[must_use]
    pub fn directory(&self) -> &std::path::Path {
        self.file_spec.directory.as_path()
    }

    /// Returns the configured `basename` of the log file.
    #[must_use]
    pub fn basename(&self) -> &str {
        &self.file_spec.basename
    }

    /// Returns the configured `discriminant`.
    #[must_use]
    pub fn discriminant(&self) -> Option<String> {
        self.file_spec.o_discriminant.clone()
    }

    /// Returns the configured `suffix`.
    #[must_use]
    pub fn suffix(&self) -> Option<String> {
        self.file_spec.get_suffix()
    }

    /// Returns `true` if UTC is enforced.
    #[must_use]
    pub fn use_utc(&self) -> bool {
        self.use_utc
    }

    /// Returns `true` if existing files are appended on program start.
    #[must_use]
    pub fn append(&self) -> bool {
        self.append
    }

    /// Returns `true` if a message should be printed on program start
    /// to which file the log is written.
    #[must_use]
    pub fn print_message(&self) -> bool {
        self.print_message
    }
}