termint

Rust library for colored printing and Terminal User Interfaces

Installation:

This library is available on crates.io. You can add it to your projects using cargo:

cargo add termint

Basic example:

Printing colored text is really easy, you can do it like this:

println!("{}", "Cyan text".fg(Fg::Cyan));

println!("{}", "Cyan text on white background".fg(Fg::Cyan).bg(Bg::White));

println!("{}", "Bold red text".fg(Fg::Red).modifier(vec![Modifier::Bold]));

println!("{}", "Text with RGB value".fg(Fg::RGB(0, 249, 210)));

You can see all the colors and modifiers in the documentation.

Advanced example:

You can also create TUIs using this library. This example shows how you can use Block widget and add children to it and creating Layout:

// Creates main block and sets its properties
let mut main = Block::new()
    .title("Termite")
    .direction(Direction::Horizontal)
    .border_type(BorderType::Double);

/// Creates block1 and adds span as its child
let mut block1 = Block::new().title("Sub block");
let span1 = "I like it!".fg(Fg::Green).bg(Bg::Yellow);
block1.add_child(Box::new(span1), Constrain::Percent(100));
/// Adds block1 as child of main block
main.add_child(Box::new(block1), Constrain::Percent(50));

/// Create block2 and adds span as its child
let mut block2 = Block::new().title("Another");
let span2 = "This is really cool, right?".fg(Fg::Blue);
block2.add_child(Box::new(span2), Constrain::Percent(100));
/// Adds block2 as child of main block
main.add_child(Box::new(block2), Constrain::Percent(50));

/// Renders the main block which renders all the children
main.render(&Coords::new(1, 1), &Coords::new(30, 8));

Usage:

Code blocks above are just examples of the usage. To see more about functions, Widgets and more, please visit the documentation.

Technologies

Obviously this library was created in Rust, but I also used library called term-size to get terminal size.