Struct flexi_logger::FileSpec

pub struct FileSpec { /* private fields */ }

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

The filename is built from several partially optional components, using this pattern:

<basename>[_<discriminant>][_<date>_<time>][_infix][.<suffix>]

The default filename pattern without rotation uses the program name as basename, no discriminant, the timestamp of the program start, and the suffix .log, e.g.

myprog_2015-07-08_10-44-11.log.

This ensures that with every program start a new trace file is written that can easily be associated with a concrete program run.

When the timestamp is suppressed with FileSpec::suppress_timestamp, you get a fixed output file. It is then worth considering whether a new program start should discard the content of an already existing outputfile or if it should append its new content to it (see Logger::append).

With rotation the timestamp is by default suppressed and instead the infix is used. The infix always starts with “_r”. For more details how its precise content can be influenced, see Naming.

Implementations

impl FileSpec

pub fn try_from<P: Into<PathBuf>>(p: P) -> Result<Self, FlexiLoggerError>

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.

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

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: Into<String>>(self, basename: S) -> Self

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: Into<String>>(self, o_basename: Option<S>) -> Self

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: Into<PathBuf>>(self, directory: P) -> Self

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: Into<PathBuf>>(self, directory: Option<P>) -> Self

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: Into<String>>(self, discriminant: S) -> Self

The specified String is added to the log file name.

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

The specified String is added to the log file name.

pub fn suffix<S: Into<String>>(self, suffix: S) -> Self

Specifies a suffix for the log files.

Equivalent to o_suffix(Some(suffix)).

pub fn o_suffix<S: Into<String>>(self, o_suffix: Option<S>) -> Self

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) -> Self

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) -> Self

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

Derives a PathBuf from the spec and the given infix.

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

Formats the value using the given formatter.

impl Default for FileSpec

fn default() -> Self

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