#cli #api #gui

ansi-colors

an ansi-coloring sceme crate that allows you to format and color your output

4 releases (2 breaking)

0.3.0 Sep 30, 2019
0.2.0 Sep 10, 2019
0.1.1 Sep 7, 2019
0.1.0 Sep 7, 2019

#208 in GUI

22 downloads per month

MIT license

34KB
351 lines

ansi-colors

CircleCI crates.io License: MIT doc.rs

What is it and what is it for?

ansi-colors is a rust crate(library) that should be used to format terminal string outputs. ansi-colors offers the ansi string coloring pallet, and the string formatting pallet in order to help you color, format and beutify you output! ansi-colors works best(for now) with the ubuntu terminal coloring scheme, but it still may work on some windows and mac computers.

How to install it?

you can use cargo(the preferable and much easier and safe way):

:~$ cargo install ansi-colors

or you can clone this repository:

:~$ git clone https://github.com/l-tools/ansi-colors ansi-colors
:~$ cd ansi-colors
:~$ cargo build

Usage

Add the following to your Cargo.toml:

[dependencies]
ansi-colors = "0.3.0"

First use import the crate:

extern crate ansi_colors;  
use ansi_colors::*; 

Then you create a new mutable coloured string using an &str primitive type

fn main(){                                                             
	let mut str1 = ColouredStr("hello ansi");

Next comes the formatting:

	str1.blue();
	str1.bold();
	str1.underline();

Finally you print:

	println!("{}",str1);
}

Together it looks like that:

fn main(){                                                             
	let mut str1 = ColouredStr("hello ansi");
	str1.blue();
	str1.bold();
	str1.underline();
	println!("{}",str1);
}

Or this:

fn main(){                                                            
	let mut str1 = ColouredStr("ERROR!!!!!");
	str1.red();
	str1.bold();
	str1.blink();
	str1.underline();
	println!("{}",str1);
}

You can use a preset design for special messages:

fn main(){                                                            
	let mut str1 = ColouredStr("ERROR!!!!!");
	str1.to_error();
	println!("{}",str1);
}

and this will print it in error format!

If you want to checkout the crate further that you should take a look in the examples folder.

Currently being developed:

  1. the ability to use them in the same row(str1.blue().bold() for example).
  2. more high level formatting options(json parsin, XML parsing and such).
  3. integrating with termi-graphics(my other crate), and creating some higher level api for the terminal graphics.

License

This crate is primarily distributed under the terms of the MIT license See LICENSE-MIT for details.

No runtime deps