Crate termstyle

termstyle: create and test the style and formatting for the text in your terminal applications

termstyle is a library that aims to make it easy to build formatted and styled command line applications.

Examples

extern crate serde_yaml;
use termstyle::{Color, El, Text};

// example raw yaml file
let example = r#"
- ["plain ", {t: "and bold", b: true}]
- ["plain ", {t: "and red", c: red}]
"#;

// deserialize as yaml (you can use `serde_json::from_str` for json, etc).
let els = termstyle::from_str(serde_yaml::from_str, example).unwrap();

// This could have also been programmatically constructed like this
let expected = vec![
    El::plain("plain ".into()),
    El::Text(Text::new("and bold".into()).bold()),
    El::plain("plain ".into()),
    El::Text(Text::new("and red".into()).color(Color::Red)),
];

assert_eq!(els, expected);

// Render directly to stdout. Can also use `El::paint` to
// do one at a time.
termstyle::paint(&mut ::std::io::stdout(), &els).unwrap();

Styled Tables

See the documentation for Table

Structs

Table

A paintable Table

TableRaw

Raw Table type, used only for deserializing.

Text

A piece of text, may be colored, etc

Enums

Color

Possible Terminal Colors

El

A Element that can be rendered as styled+formatted text using paint().

ElRaw

Raw El type, used only for deserializing.

TextRaw

Raw Text type, used only for deserializing.

TextsRaw

Raw Text type, used so you can specify "foo bar" or ["foo ", "bar"]

Functions

eprint_diff

Helper function to make tests easier for others.

eprint_repr

Print the byte representation directly to stderr.

from_str

Convert a string into Vec<El> using the given deserializer.

paint

Paint the given elements into the writer.

print_repr

Helper function to make tests easier for others.

write_repr

Helper function to make tests easier for others.