spraypaint 0.1.2

Terminal string styling for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! Demonstrates the `paint!` macro with tagged-template syntax.
//!
//! Run with: cargo run --example paint_macro

use spraypaint::{paint, styled};

fn main() {
    // Simplest form: style a span directly
    paint!("{red Error:} something went wrong");
    paint!("{green Success:} operation completed");
    paint!("{yellow Warning:} low disk space");

    println!();

    // Multiple styles separated by dots
    paint!("{red.bold FATAL:} unrecoverable error");
    paint!("{green.italic hint:} try using --help");
    paint!("{blue.underline link:} https://example.com");

    println!();

    // Nested styles
    paint!("{blue Welcome to {bold.underline spraypaint}!}");
    paint!("{dim (c) 2024 {italic spraypaint contributors}}");

    println!();

    // Dynamic Rust expressions embedded with { }
    let name = "Ferris";
    let count = 42_u32;
    paint!("Hello {green.bold {name}}, you have {cyan {count}} messages.");

    let version = env!("CARGO_PKG_VERSION");
    paint!("spraypaint v{yellow {version}}");

    println!();

    // print! variant (no newline)
    paint!(inline, "{yellow Loading}");
    paint!(inline, ".");
    paint!(inline, ".");
    paint!(inline, ".");
    println!(" done");

    println!();

    // stderr variant
    paint!(stderr, "{red.bold [ERROR]} this goes to stderr");

    println!();

    // styled! -- returns a String, doesn't print
    let msg = styled!("{red.bold Error:} disk full");
    // Can be used in normal format strings, log macros, etc.
    eprintln!("logged: {msg}");

    let greeting = styled!("Hello {green {name}}!");
    let len = greeting.len();
    println!("Greeting ({len} chars including ANSI): {greeting}");
}