minicrossterm/crossterm_style

Crossterm Style | cross-platform styling.

This crate allows you to style the terminal cross-platform. It supports all UNIX and windows terminals down to windows 7 (not all terminals are tested see Tested Terminals for more info)

This crate is a sub-crate of crossterm to style the terminal, and can be use individually.

Other sub-crates are:

• Crossterm Input
• Crossterm Terminal
• Crossterm Screen
• Crossterm Cursor

When you want to use other modules as well you might want to use crossterm with feature flags.

Table of contents:

• Getting started
• Useful links
• Features
• Examples
• Tested Terminals
• Notice
• Contributing
• Authors
• License

Getting Started

This documentation is only for crossterm_style version 0.3 if you have an older version I suggest you check the Upgrade Manual. Also, check out the examples folders with detailed examples for all functionality of this crate.

Add the crossterm_style package to your Cargo.toml file.

[dependencies]
crossterm_style = "0.3"

And import the crossterm_style modules you want to use.

pub use crossterm_style::{color, style, Attribute, Color, ColorType, ObjectStyle, StyledObject, TerminalColor, Colorize, Styler};

Useful Links

• Documentation
• Crates.io
• Book
• Examples

Features

These are the features of this crate:

• Cross-platform
• Multithreaded (send, sync)
• Detailed Documentation
• Few Dependencies
• Styled output
  • Foreground Color (16 base colors)
  • Background Color (16 base colors)
  • 256 (ANSI) Color Support (Windows 10 and UNIX Only)
  • RGB Color Support (Windows 10 and UNIX only)
  • Text Attributes: bold, italic, underscore and crossed word and more (Windows 10 and UNIX only)

Examples

The examples folder has more complete and verbose examples.

style text with attributes

use crossterm_style::{Colored, Color, Colorize, Styler, Attribute};

// pass any `Attribute` value to the formatting braces.
println!("{} Underlined {} No Underline", Attribute::Underlined, Attribute::NoUnderline);

// you could also call different attribute methods on a `&str` and keep on chaining if needed.
let styled_text = "Bold Underlined".bold().underlined();
println!("{}", styled_text);

// old-way but still usable
let styled_text = style("Bold Underlined").bold().underlined();

style text with colors

use crossterm_style::{Colored, Color, Colorize};

println!("{} Red foreground color", Colored::Fg(Color::Red));
println!("{} Blue background color", Colored::Bg(Color::Blue));

// you can also call different coloring methods on a `&str`.
let styled_text = "Bold Underlined".red().on_blue();
println!("{}", styled_text);

// old-way but still usable
let styled_text = style("Bold Underlined").with(Color::Red).on(Color::Blue);

style text with RGB and ANSI Value

// custom rgb value (Windows 10 and UNIX systems)
println!("{} some colored text", Colored::Fg(Color::Rgb {
    r: 10,
    g: 10,
    b: 10
}));

// custom ansi color value (Windows 10 and UNIX systems)
println!("{} some colored text", Colored::Fg(Color::AnsiValue(10)));

Tested terminals

• Windows Powershell
  • Windows 10 (pro)
• Windows CMD
  • Windows 10 (pro)
  • Windows 8.1 (N)
• Ubuntu Desktop Terminal
  • Ubuntu 17.10
• (Arch, Manjaro) KDE Konsole
• Linux Mint

This crate supports all Unix terminals and windows terminals down to Windows 7 but not all of them have been tested. If you have used this library for a terminal other than the above list without issues feel free to add it to the above list, I really would appreciate it.

Authors

• Timon Post - Project Owner & creator

License

This project is licensed under the MIT License - see the LICENSE.md file for details