Skip to content

A macro to generate styled ansi escape sequence from markup language

License

Notifications You must be signed in to change notification settings

7sDream/tui-markup-ansi-macro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

A macro to generate styled ansi escape sequence from markup language

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages