Struct custom_utils::logger::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) -> FileSpecwhere 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>) -> FileSpecwhere 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) -> FileSpecwhere 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>) -> FileSpecwhere 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) -> FileSpecwhere S: Into<String>,

The specified String is added to the log file name.

pub fn o_discriminant<S>(self, o_discriminant: Option<S>) -> FileSpecwhere S: Into<String>,

The specified String is added to the log file name.

pub fn suffix<S>(self, suffix: S) -> FileSpecwhere 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>) -> FileSpecwhere 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 copy 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<FileSpec> for FileSpec

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for FileSpec

impl StructuralEq for FileSpec

impl StructuralPartialEq for FileSpec