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.