Yansi: A dead simple ANSI terminal color painting library for Rust

yansi

A dead simple ANSI terminal color painting library.

use yansi::Paint;

println!("Testing, {}, {}, {}!",
    "Ready".bold(),
    "Set".black().on_yellow().invert().italic(),
    "STOP".white().on_red().bright().underline().bold());

> Testing, Ready, Set, STOP!

Features

Why yet another ANSI terminal coloring library? Here are some reasons:

• This library makes simple things simple: use Paint and go!
• Zero dependencies by default. It really is simple.
• Zero allocations except as needed by opt-in wrapping.
• Automatic Windows support for the vast majority (95%+) of Windows users.
• Featureful no_std, no-alloc, support with default-features = false.
• Style constructors are const: store styles statically, even with dynamic conditions!
• Any type implementing a formatting trait can be styled, not just strings.
• Styling can be enabled and disabled globally and dynamically, on the fly.
• A Style can be predicated on arbitrary conditions.
• Formatting specifiers like {:x} and {:08b} are supported and preserved!
• Built-in (optional) conditions for TTY detection and common environment variables.
• Arbitrary items can be masked for selective disabling.
• Styling can wrap to preserve styling across resets.
• Styling can linger beyond a single value.
• Experimental support for hyperlinking is included.
• The name yansi is pretty cool 😎.

License

yansi is licensed under either of the following, at your option:

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)

.gitignore

/target
Cargo.lock

Cargo.toml

[package]
name = "yansi"
version = "1.0.0-rc"
authors = ["Sergio Benitez <sb@sergio.bz>"]
repository = "https://github.com/SergioBenitez/yansi"
documentation = "https://docs.rs/yansi"
description = "A dead simple ANSI terminal color painting library."
keywords = ["ansi", "terminal", "color", "format", "paint"]
readme = "README.md"
license = "MIT OR Apache-2.0"
categories = ["command-line-interface"]
rust-version = "1.63"
edition = "2021"

[package.metadata.docs.rs]
all-features = true

[features]
default = ["std"]
detect-tty = ["is-terminal", "std"]
detect-env = ["std"]
hyperlink = ["std"]
std = ["alloc"]
alloc = []

# hidden feature to enable nightly doc cfg
_nightly = []

[dependencies]
is-terminal = { version = "0.4.7", optional = true }

Download details:

Author: SergioBenitez
Source:  https://github.com/SergioBenitez/yansi

License: Apache-2.0, MIT licenses found

#rust