#terminal-colors #ansi-term #terminal #color #cli #env-var

no-std owo-colors

Zero-allocation terminal colors that'll make people go owo

28 releases (stable)

5.0.0 Sep 10, 2024
4.1.0 Sep 10, 2024
4.0.0 Dec 20, 2023
4.0.0-rc.1 Oct 13, 2023
0.0.0 Aug 25, 2020

#10 in Command-line interface

Download history 431394/week @ 2024-08-24 414066/week @ 2024-08-31 426290/week @ 2024-09-07 385814/week @ 2024-09-14 442750/week @ 2024-09-21 442488/week @ 2024-09-28 457887/week @ 2024-10-05 458030/week @ 2024-10-12 454729/week @ 2024-10-19 431858/week @ 2024-10-26 434987/week @ 2024-11-02 457381/week @ 2024-11-09 471289/week @ 2024-11-16 439136/week @ 2024-11-23 500462/week @ 2024-11-30 440160/week @ 2024-12-07

1,922,152 downloads per month
Used in 1,752 crates (426 directly)

MIT license

125KB
2.5K SLoC

Colors

Current Crates.io Version docs-rs MSRV 1.56+ Downloads

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

Supports:

  • All std/core formatters
  • Optional checking for if a terminal supports colors
    • Enabled for CI
    • Disabled by default for non-terminal outputs
    • Overridable by NO_COLOR/FORCE_COLOR environment variables
    • Overridable programmatically via set_override
  • Dependency-less by default
  • Hand picked names for all ANSI (4-bit) and Xterm (8-bit) colors
  • Support for RGB colors
  • Set colors at compile time by generics or at runtime by value
  • All ANSI colors
    • Basic support (normal and bright variants)
    • Xterm support (high compatibility and 256 colors)
    • Truecolor support (modern, 48-bit color)
  • 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)

Dependencies

~0–6.5MB
~36K SLoC