#markup-language #ansi #markup #ansi-term #text #terminal #color

macro tui-markup-ansi-macro

a macro to generate styled ansi escape sequence from markup language

1 unstable release

0.1.0 Aug 23, 2022

#80 in #markup-language

BSD-3-Clause-Clear

10KB
109 lines

tui markup ansi macro

crates.io changelog docs.rs deps state

This create provided a macro to generated terminal styled text in ANSI escape sequence format using a markup language.

This macro compile your source at compile time, so it has no runtime overhead.

Example

use tui_markup_ansi_macro::ansi;

let generated = ansi!("Press <blue Space> to <cyan Jump> over the <bg:yellow,i fox>");
let hardcode = "Press \u{001b}[34mSpace\u{001b}[0m to \u{001b}[36mJump\u{001b}[0m over the \u{001b}[3;43mfox\u{001b}[0m";
// Those two are equivalent.
assert_eq!(generated, hardcode);

// Use custom tag
let generated = ansi!(
    "Press <keyboard Space> to <action Jump> over the <enemy fox>", 
    "keyboard" => "blue",
    "action" => "cyan",
    "enemy" => "bg:yellow,i",
);
assert_eq!(generated, hardcode);

println!("{}", generated);

Output:

example-output

The markup language used here is my tui markup language, See it's documentation for full syntax and supported style tags.

LICENSE

BSD-3-Clause-Clear, see LICENSE.

Dependencies

~1.2–1.7MB
~27K SLoC