Crates.io | termal_proc |
lib.rs | termal_proc |
version | 1.1.0 |
source | src |
created_at | 2024-01-24 12:50:12.930248 |
updated_at | 2024-08-06 14:31:13.52286 |
description | Rust library for fancy colored cli using ansi codes |
homepage | https://github.com/BonnyAD9/termal |
repository | https://github.com/BonnyAD9/termal |
max_upload_size | |
id | 1112132 |
size | 40,028 |
Rust library for terminal features with ansi escape codes.
Currently the library contains the ansii codes, and a special macro. Works for text styles, colors and moving the cursor.
use termal::*;
// you can use a special macro to inline the color codes, this will write
// italic text with yellow foreground and reset at the end.
printcln!("{'yellow italic}hello{'reset}");
// the macro also supports standard formatting
printcln!("{'yellow italic}{}{'reset}", "hello");
// you can also use short versions of the codes
printcln!("{'y i}{}{'_}", "hello");
// you can also use true colors with their hex codes
printcln!("{'#dd0 i}{}{'_}", "hello");
// Move cursor to position column 5 on line 7 and write 'hello' in italic
// yellow
use termal::codes::*;
println!("{}{YELLOW_FG}{ITALIC}hello{RESET}", move_to!(5, 7));
The macros such as move_to!
can accept either literals or dynamic values.
Its main feature is that if you supply literals, it expands to a string
literal with the ansi code.
If you however supply dynamic values it expands to a format!
macro:
use termal::codes::*;
let a = move_to!(5, 7);
// expands to:
let a = "\x1b[5;7H";
let b = move_to!(2 + 3, 7);
// expands to:
let b = format!("\x1b[{};{}H", 2 + 3, 7);
If you know the values for the arguments you can also use the *c
macros:
use termal::formatc;
// the spaces, or the lack of them is important
let a = formatc!("{'move_to5,7}");
Youn can create gradients with the function termal::gradient
:
use termal::*;
// This will create foreground gradient from the rgb color `(250, 50, 170)`
// to the rgb color `(180, 50, 240)`
printcln!("{}{'_}", gradient("BonnyAD9", (250, 50, 170), (180, 50, 240)));
To see all the possible commands and uses see docs.
It is available on crates.io:
cargo add termal
[dependencies]
termal = "1.0.0"