Crate ansi_rgb

Colorful console text using ANSI escape sequences.

• Very simple API
• Full color (using the rgb crate)
• Colors all the formatting traits
• no_std compliant

Foreground colors

use ansi_rgb::{ Foreground, red };

println!("{}", "Hello, world!".fg(red()));

Output:

Hello, world!

Background colors

use ansi_rgb::{ Background, red };

println!("{}", "Hello, world!".bg(red()));

Output:

Hello, world!

Mix and match

# Cargo.toml
[dependencies]
rbg = "0.8"

use ansi_rgb::{ Foreground, Background };
use rgb::RGB8;

let fg = RGB8::new(123, 231, 111);
let bg = RGB8::new(10, 100, 20);
println!("{}", "Yuck".fg(fg).bg(bg));

Output:

Yuck

Anything formattable

#[derive(Debug)]
struct Foo(i32, i32);

let foo = Foo(1, 2);
println!("{:?}", foo.fg(green()));

Output:

Foo(1, 2)

Windows users

You need to set your console mode. Otherwise you’ll get garbage like this:

�[48;2;159;114;0m �[0m

Structs

WithBackground

Something with a background color

WithForeground

Something with a foreground color

Traits

Background

Adds a background color

Foreground

Adds a foreground color

Functions

black

Makes black

blue

Makes blue

blue_magenta

Makes blue magenta

cyan

Makes cyan

cyan_blue

Makes cyan blue

green

Makes green

green_cyan

Makes green cyan

magenta

Makes magenta

magenta_pink

Makes magenta pink

orange

Makes orange

red

Makes red

white

Makes white

yellow

Makes yellow

yellow_green

Makes yellow green