Colors

A zero-allocation no_std-compatible zero-cost way to add color to your Rust terminal to make people go owo.

Supports:

• [x] All std/core formatters
  • [x] Display
  • [x] Debug
  • [x] Octal
  • [x] LowerHex
  • [x] UpperHex
  • [x] Pointer
  • [x] Binary
  • [x] LowerExp
  • [x] UpperExp
• [x] Optional checking for if a terminal supports colors
  • [x] Enabled for CI
  • [x] Disabled by default for non-terminal outputs
  • [x] Overridable by NO_COLOR/FORCE_COLOR environment variables
  • [x] Overridable programmatically via set_override
• [x] Dependency-less by default
• [x] Hand picked names for all ANSI (4-bit) and Xterm (8-bit) colors
• [x] Support for RGB colors
• [x] Set colors at compile time by generics or at runtime by value
• [x] All ANSI colors
  • [x] Basic support (normal and bright variants)
  • [x] Xterm support (high compatibility and 256 colors)
  • [x] Truecolor support (modern, 48-bit color)
• [x] Styling (underline, strikethrough, etc)

owo-colors is also more-or-less a drop-in replacement for colored, allowing colored to work in a no_std environment. No allocations or dependencies required because embedded systems deserve to be pretty too uwu.

To add to your Cargo.toml:

owo-colors = "3"

Example

use owo_colors::OwoColorize;

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

Generic colors

use owo_colors::OwoColorize;
use owo_colors::colors::*;

fn main() {
    // Generically color
    println!("My number might be {}!", 4.fg::<Black>().bg::<Yellow>());
}

Stylize

use owo_colors::OwoColorize;

println!("{}", "strikethrough".strikethrough());

Only Style on Supported Terminals

use owo_colors::{OwoColorize, Stream::Stdout};

println!(
    "{}",
    "colored blue if a supported terminal"
        .if_supports_color(Stdout, |text| text.bright_blue())
);

Supports NO_COLOR/FORCE_COLOR environment variables, checks if it's a tty, checks if it's running in CI (and thus likely supports color), and checks which terminal is being used. (Note: requires supports-colors feature)