Stilo

A small library for stylizing terminal text with ANSI color codes, with ergonomic macros.

Usage

Add stilo = "0.2.2" to your Cargo.toml dependencies

stylize!

Creates a Style struct and formats text.

Docs

use stilo::stylize;

// Red
println!("{}", stylize!("Hello": Red));

// Red, italic, and bold
println!("{}", stylize!("Hello": Red + italic+bold));

// Default color, italic and bold
println!("{}", stylize!("Hello": +i+b));

// Format string
let world = "World!";
println!("{}", stylize!("Hello {}": Green + i+b, world));

stylize_many! and println!_styles!

Stylize many strings individually, and concatenate.

• stylize_many!: Returns a String of formatted text
• println_styles!: Prints a String of formatted text to stdout, with newline.
• • Same as println!("{}", stylize_many!( ... ))

Docs

use stilo::stylize_many;
let world = "World!";

// `println!("{}", stylize_many!` would also work in this example
println_styles!(
    // Red
    "Hello\n": Red;
    // Red, italic, and bold
    "Hello\n": Red + italic+bold;
    // Default color, italic and bold
    "Hello\n": +i+b;
    // Format string
    "Hello {}": Green + i+b, world;
);

style!

Creates a Style struct, without formatting text.

Docs

// Red
let style = style!(Red);
println!("{}", style.format("Hello"));

// Red, italic, and bold
let style = style!(Red + italic + bold);
println!("{}", style.format("Hello"));

// Default color, italic and bold
let style = style!(+i+b);
println!("{}", style.format("Hello"));

No macros

use stilo::{Style, Color::*, style_format};

// Create a new style with the builder pattern
// `Style` implements `Copy`
let style = Style::new().color(Red).italic();

// OOP Syntax
println!("{}", style.format("Hello!"));
// Functional syntax
println!("{}", style_format("Hello!", style));