8 releases (4 breaking)

0.5.0 Jan 10, 2021
0.4.1 Aug 21, 2020
0.3.0 Aug 4, 2020
0.2.2 Aug 2, 2020
0.1.0 Aug 1, 2020

#11 in #colorful

Apache-2.0

13KB
160 lines

Colory

build

A simple library to make your command line application more colorful!

Getting Started

To use colory in your project, add it to the dependencies section in you Cargo.toml

[dependencies]
colory = "0.5.0"

This will allow Cargo to download, build, and cache the colory as a package directly from crates.io.

use colory::{ForegroundColor as fg, colory_init};

fn main() {
    colory_init(); // required to call this on windows. It will do nothing on *nix systems.
    println!("{}Hello, world!{}", fg::Green, fg::Normal);
}

For more complex examples, see the examples directory.

Platform Support

Here is a list of prominent terminal emulators that support ansi escape codes(this list is not complete, contribute by opening an issue or a pull request) -

Unix Like

  • Linux console
  • GNU Screen
  • Minicorn
  • tmux

macOs

  • Terminal
  • iTerm2
  • xterm

Microsoft Windows

  • AlphaCom
  • ConEmu
  • mintty
  • PuTTy
  • Windows Terminal
  • Windows Console (aka cmd)
  • Powershell

If you terminal emulator is not in the list, download this library and run some of the examples. If they do not work, then your terminal probably does not support it.

Note: This library may not work with terminals that do not support ansi escape codes.

No runtime deps