Trait owo_colors::OwoColorize[−][src]

pub trait OwoColorize: Sized {

Show 52 methods    fn fg<'a, C: Color>(&'a self) -> FgColorDisplay<'a, C, Self> { ... }

    fn bg<'a, C: Color>(&'a self) -> BgColorDisplay<'a, C, Self> { ... }

    fn black<'a>(&'a self) -> FgColorDisplay<'a, Black, Self> { ... }

    fn on_black<'a>(&'a self) -> BgColorDisplay<'a, Black, Self> { ... }

    fn red<'a>(&'a self) -> FgColorDisplay<'a, Red, Self> { ... }

    fn on_red<'a>(&'a self) -> BgColorDisplay<'a, Red, Self> { ... }

    fn green<'a>(&'a self) -> FgColorDisplay<'a, Green, Self> { ... }

    fn on_green<'a>(&'a self) -> BgColorDisplay<'a, Green, Self> { ... }

    fn yellow<'a>(&'a self) -> FgColorDisplay<'a, Yellow, Self> { ... }

    fn on_yellow<'a>(&'a self) -> BgColorDisplay<'a, Yellow, Self> { ... }

    fn blue<'a>(&'a self) -> FgColorDisplay<'a, Blue, Self> { ... }

    fn on_blue<'a>(&'a self) -> BgColorDisplay<'a, Blue, Self> { ... }

    fn magenta<'a>(&'a self) -> FgColorDisplay<'a, Magenta, Self> { ... }

    fn on_magenta<'a>(&'a self) -> BgColorDisplay<'a, Magenta, Self> { ... }

    fn purple<'a>(&'a self) -> FgColorDisplay<'a, Magenta, Self> { ... }

    fn on_purple<'a>(&'a self) -> BgColorDisplay<'a, Magenta, Self> { ... }

    fn cyan<'a>(&'a self) -> FgColorDisplay<'a, Cyan, Self> { ... }

    fn on_cyan<'a>(&'a self) -> BgColorDisplay<'a, Cyan, Self> { ... }

    fn white<'a>(&'a self) -> FgColorDisplay<'a, White, Self> { ... }

    fn on_white<'a>(&'a self) -> BgColorDisplay<'a, White, Self> { ... }

    fn bright_black<'a>(&'a self) -> FgColorDisplay<'a, BrightBlack, Self> { ... }

    fn on_bright_black<'a>(&'a self) -> BgColorDisplay<'a, BrightBlack, Self> { ... }

    fn bright_red<'a>(&'a self) -> FgColorDisplay<'a, BrightRed, Self> { ... }

    fn on_bright_red<'a>(&'a self) -> BgColorDisplay<'a, BrightRed, Self> { ... }

    fn bright_green<'a>(&'a self) -> FgColorDisplay<'a, BrightGreen, Self> { ... }

    fn on_bright_green<'a>(&'a self) -> BgColorDisplay<'a, BrightGreen, Self> { ... }

    fn bright_yellow<'a>(&'a self) -> FgColorDisplay<'a, BrightYellow, Self> { ... }

    fn on_bright_yellow<'a>(&'a self) -> BgColorDisplay<'a, BrightYellow, Self> { ... }

    fn bright_blue<'a>(&'a self) -> FgColorDisplay<'a, BrightBlue, Self> { ... }

    fn on_bright_blue<'a>(&'a self) -> BgColorDisplay<'a, BrightBlue, Self> { ... }

    fn bright_magenta<'a>(&'a self) -> FgColorDisplay<'a, BrightMagenta, Self> { ... }

    fn on_bright_magenta<'a>(
        &'a self
    ) -> BgColorDisplay<'a, BrightMagenta, Self> { ... }

    fn bright_purple<'a>(&'a self) -> FgColorDisplay<'a, BrightMagenta, Self> { ... }

    fn on_bright_purple<'a>(&'a self) -> BgColorDisplay<'a, BrightMagenta, Self> { ... }

    fn bright_cyan<'a>(&'a self) -> FgColorDisplay<'a, BrightCyan, Self> { ... }

    fn on_bright_cyan<'a>(&'a self) -> BgColorDisplay<'a, BrightCyan, Self> { ... }

    fn bright_white<'a>(&'a self) -> FgColorDisplay<'a, BrightWhite, Self> { ... }

    fn on_bright_white<'a>(&'a self) -> BgColorDisplay<'a, BrightWhite, Self> { ... }

    fn bold<'a>(&'a self) -> BoldDisplay<'a, Self> { ... }

    fn dimmed<'a>(&'a self) -> DimDisplay<'a, Self> { ... }

    fn italic<'a>(&'a self) -> ItalicDisplay<'a, Self> { ... }

    fn underline<'a>(&'a self) -> UnderlineDisplay<'a, Self> { ... }

    fn blink<'a>(&'a self) -> BlinkDisplay<'a, Self> { ... }

    fn blink_fast<'a>(&'a self) -> BlinkFastDisplay<'a, Self> { ... }

    fn reversed<'a>(&'a self) -> ReversedDisplay<'a, Self> { ... }

    fn hidden<'a>(&'a self) -> HiddenDisplay<'a, Self> { ... }

    fn strikethrough<'a>(&'a self) -> StrikeThroughDisplay<'a, Self> { ... }

    fn color<'a, Color: DynColor>(
        &'a self, 
        color: Color
    ) -> FgDynColorDisplay<'a, Color, Self> { ... }

    fn on_color<'a, Color: DynColor>(
        &'a self, 
        color: Color
    ) -> BgDynColorDisplay<'a, Color, Self> { ... }

    fn truecolor<'a>(
        &'a self, 
        r: u8, 
        g: u8, 
        b: u8
    ) -> FgDynColorDisplay<'a, Rgb, Self> { ... }

    fn on_truecolor<'a>(
        &'a self, 
        r: u8, 
        g: u8, 
        b: u8
    ) -> BgDynColorDisplay<'a, Rgb, Self> { ... }

    fn style(&self, style: Style) -> Styled<&Self> { ... }

}
Expand description

Extension trait for colorizing a type which implements any std formatter (Display, Debug, UpperHex, etc.)

Example

use owo_colors::OwoColorize;

fn main() {
    println!("My number is {:#x}!", 10.green());
    println!("My number is not {}!", 4.on_red());
}

How to decide which method to use

Do you have a specific color you want to use?

Use the specific color’s method, such as blue or on_green.

Do you want your colors configurable via generics?

Use fg and bg to make it compile-time configurable.

Do you need to pick a color at runtime?

Use the color, on_color, truecolor or on_truecolor.

Do you need some other text modifier?

Do you want it to only display colors if it’s a terminal?

  1. Enable the tty feature
  2. Colorize inside if_stdout_tty or if_stdout_tty

Provided methods

Set the foreground color generically

use owo_colors::{OwoColorize, colors::*};

println!("{}", "red foreground".fg::<Red>());

Set the background color generically.

use owo_colors::{OwoColorize, colors::*};

println!("{}", "black background".bg::<Black>());

Change the foreground color to black

Change the foreground color to black

Change the foreground color to red

Change the foreground color to red

Change the foreground color to green

Change the foreground color to green

Change the foreground color to yellow

Change the foreground color to yellow

Change the foreground color to blue

Change the foreground color to blue

Change the foreground color to magenta

Change the foreground color to magenta

Change the foreground color to purple

Change the foreground color to purple

Change the foreground color to cyan

Change the foreground color to cyan

Change the foreground color to white

Change the foreground color to white

Change the foreground color to bright black

Change the foreground color to bright black

Change the foreground color to bright red

Change the foreground color to bright red

Change the foreground color to bright green

Change the foreground color to bright green

Change the foreground color to bright yellow

Change the foreground color to bright yellow

Change the foreground color to bright blue

Change the foreground color to bright blue

Change the foreground color to bright magenta

Change the foreground color to bright magenta

Change the foreground color to bright purple

Change the foreground color to bright purple

Change the foreground color to bright cyan

Change the foreground color to bright cyan

Change the foreground color to bright white

Change the foreground color to bright white

Make the text bold

Make the text dim

Make the text italicized

Make the text italicized

Make the text blink

Make the text blink (but fast!)

Swap the foreground and background colors

Hide the text

Cross out the text

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either OwoColorize::fg or a color-specific method, such as OwoColorize::green,

use owo_colors::{OwoColorize, AnsiColors};

fn main() {
    println!("{}", "green".color(AnsiColors::Green));
}

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either OwoColorize::bg or a color-specific method, such as OwoColorize::on_yellow,

use owo_colors::{OwoColorize, AnsiColors};

fn main() {
    println!("{}", "yellow background".on_color(AnsiColors::BrightYellow));
}

Sets the foreground color to an RGB value.

Sets the background color to an RGB value.

Apply a runtime-determined style

Implementors