logo
pub struct Style { /* private fields */ }
Expand description

A set of styles to apply to the terminal output.

Call Formatter::style to get a Style and use the builder methods to set styling properties, like color and weight. To print a value using the style, wrap it in a call to value when the log record is formatted.

Examples

Create a bold, red colored style and use it to print the log level:

use std::io::Write;
use env_logger::fmt::Color;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut level_style = buf.style();

    level_style.set_color(Color::Red).set_bold(true);

    writeln!(buf, "{}: {}",
        level_style.value(record.level()),
        record.args())
});

Styles can be re-used to output multiple values:

use std::io::Write;
use env_logger::fmt::Color;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut bold = buf.style();

    bold.set_bold(true);

    writeln!(buf, "{}: {} {}",
        bold.value(record.level()),
        bold.value("some bold text"),
        record.args())
});

Implementations

Set the text color.

Examples

Create a style with red text:

use std::io::Write;
use env_logger::fmt::Color;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut style = buf.style();

    style.set_color(Color::Red);

    writeln!(buf, "{}", style.value(record.args()))
});

Set the text weight.

If yes is true then text will be written in bold. If yes is false then text will be written in the default weight.

Examples

Create a style with bold text:

use std::io::Write;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut style = buf.style();

    style.set_bold(true);

    writeln!(buf, "{}", style.value(record.args()))
});

Set the text intensity.

If yes is true then text will be written in a brighter color. If yes is false then text will be written in the default color.

Examples

Create a style with intense text:

use std::io::Write;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut style = buf.style();

    style.set_intense(true);

    writeln!(buf, "{}", style.value(record.args()))
});

Set the background color.

Examples

Create a style with a yellow background:

use std::io::Write;
use env_logger::fmt::Color;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut style = buf.style();

    style.set_bg(Color::Yellow);

    writeln!(buf, "{}", style.value(record.args()))
});

Wrap a value in the style.

The same Style can be used to print multiple different values.

Examples

Create a bold, red colored style and use it to print the log level:

use std::io::Write;
use env_logger::fmt::Color;

let mut builder = env_logger::Builder::new();

builder.format(|buf, record| {
    let mut style = buf.style();

    style.set_color(Color::Red).set_bold(true);

    writeln!(buf, "{}: {}",
        style.value(record.level()),
        record.args())
});

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.