Crate fmtlog

A simple configurable logger with format specification.

This crate provides an implementation of log crate, which provides integrated logging interface.

Examples

Basic

#[macro_use]
extern crate log;
extern crate fmtlog;

fn main() {
    fmtlog::default().set().unwrap();

    info!("Hello!"); // INFO: Hello!
}

See also the function default.

Configure in Code

#[macro_use]
extern crate log;
extern crate fmtlog;

use fmtlog::{Config, LevelFilter};

fn main() {
    fmtlog::new(Config::new().level(LevelFilter::Trace))
        .set()
        .unwrap();

    info!("Hello!"); // INFO: Hello!
}

See also the struct Config.

Format Specification

The format string is basically a string, but the following specifiers will converted into another string.

Spec.	Example	Description
%%		Literal %.
%}		Literal }. (use in {}.)
%N	hyper	The target of the log.
%f	main.rs	The file that the log defined.
%S	main.rs:15	The file and line that the log defined.
%M	An error has occured.	The log message.
%l	info	The log level. (lowercase)
%L	INFO	The log level. (uppercase)
%T(<format>)	%T(%D %T) -> 01/01/21 12:00:00	The local time. (see chrono's format specification). Requires feature: chrono
%U(<format>)	%T(%D %T) -> 01/01/21 12:00:00	The UTC time. (see chrono's format specification). Requires feature: chrono
%F(<color>){...}		Set the foreground color. Requires feature: colored
%F(<error>,<warn>,<info>,<debug>,<trace>){...}		Set the foreground color. (Branch by the log level.) Requires feature: colored
%B(<color>){...}		Set the background color. Requires feature: colored
%B(<error>,<warn>,<info>,<debug>,<trace>){...}		Set the background color. (Branch by the log level.) Requires feature: colored
%b{...}		Bold the text. Requires feature: colored
%d{...}		Dim the text color. Requires feature: colored
%i{...}		Print the text in italics. Requires feature: colored
%r{...}		Reverse the foreground and background color. Requires feature: colored
%u{...}		Underline the text. Requires feature: colored
%s{...}		Strikethrough the text. Requires feature: colored

Supported Color (Requires feature: colored)

All supported color used by %C and %O is here.

• black
• red
• green
• yellow
• blue
• magenta (= purple)
• cyan
• white
• bright black
• bright red
• bright green
• bright yellow
• bright blue
• bright magenta
• bright cyan
• bright white
• #ffffff (Hexadecimal RGB)

Modules

formats

Formats Collection (See the document.)

Structs

Config	The logger settings.
Logger	The body of fmtlog.

Enums

Colorize	Colorize the output
LevelFilter	An enum representing the available verbosity level filters of the logger.
Output	The Output type

Functions

default	Create a logger by default settings.
new	Create a logger by custom settings.