Struct FileSpec 

pub struct FileSpec { /* private fields */ }

Builder object for specifying the name and path of the log output file.

assert_eq!(
    FileSpec::default()
        .directory("/a/b/c")
        .basename("foo")
        .suppress_timestamp()
        .suffix("bar"),
    FileSpec::try_from("/a/b/c/foo.bar").unwrap()
);

Implementations

impl FileSpec

pub fn try_from<P>(p: P) -> Result<FileSpec, FlexiLoggerError>

where P: Into<PathBuf>,

The provided path should describe a log file. If it exists, it must be a file, not a folder. If necessary, parent folders will be created.

Errors

FlexiLoggerError::OutputBadFile if the given path exists and is a folder.

Panics

Panics if the basename of the given path has no filename

pub fn basename<S>(self, basename: S) -> FileSpec

where S: Into<String>,

The specified String is used as the basename of the log file name, instead of the program name. Using a file separator within the argument is discouraged.

pub fn o_basename<S>(self, o_basename: Option<S>) -> FileSpec

where S: Into<String>,

The specified String is used as the basename of the log file, instead of the program name, which is used when None is given.

pub fn directory<P>(self, directory: P) -> FileSpec

where P: Into<PathBuf>,

Specifies a folder for the log files.

If the specified folder does not exist, it will be created. By default, the log files are created in the folder where the program was started.

pub fn o_directory<P>(self, directory: Option<P>) -> FileSpec

where P: Into<PathBuf>,

Specifies a folder for the log files.

If the specified folder does not exist, it will be created. With None, the log files are created in the folder where the program was started.

pub fn discriminant<S>(self, discriminant: S) -> FileSpec

where S: Into<String>,

The specified String is added to the log file name.

pub fn o_discriminant<S>(self, o_discriminant: Option<S>) -> FileSpec

where S: Into<String>,

The specified String is added to the log file name.

pub fn suffix<S>(self, suffix: S) -> FileSpec

where S: Into<String>,

Specifies a suffix for the log files.

Equivalent to o_suffix(Some(suffix)).

pub fn o_suffix<S>(self, o_suffix: Option<S>) -> FileSpec

where S: Into<String>,

Specifies a suffix for the log files, or supresses the use of a suffix completely.

The default suffix is “log”.

pub fn suppress_timestamp(self) -> FileSpec

Makes the logger not include a timestamp into the names of the log files

Equivalent to use_timestamp(false).

pub fn use_timestamp(self, use_timestamp: bool) -> FileSpec

Defines if a timestamp should be included into the names of the log files.

The default behavior depends on the usage:

• without rotation, a timestamp is by default included into the name
• with rotation, the timestamp is by default suppressed

pub fn as_pathbuf(&self, o_infix: Option<&str>) -> PathBuf

Creates a PathBuf to the described log file.

It is composed like this: <directory>/<basename>_<discr>_<timestamp><infix>.<suffix>

Trait Implementations

impl Clone for FileSpec

fn clone(&self) -> FileSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileSpec

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

Formats the value using the given formatter.

impl Default for FileSpec

fn default() -> FileSpec

Describes a file in the current folder, using, as its filestem the program name followed by the current timestamp, and the suffix “.log”.

impl PartialEq for FileSpec

fn eq(&self, other: &FileSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FileSpec

impl StructuralPartialEq for FileSpec