5 stable releases

1.1.2 May 25, 2024
1.1.1 Nov 21, 2023
1.0.1 Nov 10, 2023
1.0.0 Jul 30, 2023

#260 in Command-line interface


Used in paclog

MIT license

6KB
51 lines

zen-colour

The most minimal terminal colour and style crate. Contains constants with colour and style codes. Just throw them into your string and bob's your uncle.

use zen_colour::*;
println!("{}this is red{}", RED, RESET);
println!("{BLUE}blue{RESET}");
println!("{r}r{g}g{r}r{g}g{r}r{g}g", r = RED, g = GREEN);

constants

Styles:

  • RESET
  • BOLD
  • FAINT
  • ITALIC
  • UNDERLINED
  • BLINK
  • EFFECT6
  • EFFECT7
  • HIDDEN
  • CROSSED

Text colours:

  • BLACK
  • RED
  • GREEN
  • YELLOW
  • BLUE
  • MAGENTA
  • CYAN
  • WHITE
  • DEFAULT

Background colours:

  • BG_BLACK
  • BG_RED
  • BG_GREEN
  • BG_YELLOW
  • BG_BLUE
  • BG_MAGENTA
  • BG_CYAN
  • BG_WHITE
  • BG_DEFAULT

names

If you don't like the constant names.

use zen_colours::*;
const R: &str = RED;

non standard colours

The standard colours are chosen by the user. They want to see those colours. The non standard colours (RGB for example) are not chosen by the user. They will just clash with the standard colours and your application will not look consistent with other programs on the users system. They must never be used unless you are doing some kind of graphics, as opposed to UI. This is why this crate just does not support them. This battle is unfortunately lost in the GUI space. May the terminal stay strong.

why

There are many crates that do the same. With all kinds of handy functions. There are different styles of library design.

println!("red".colour(red))
print_colour("red", red);

But in the end, it all annoyed me, especially when do doing more complex colouring. For example, if you want to colour a date string but want all the '/' to be faint. Then have more colours in the same line for different values. This is just a mess or mega verbose with any library design no matter how reasonable. I just ended up throwing the colour codes right into the print! or format!. And now we are here. Nice, easy, clean, no complexity, just colours and styles.

more features?

no.

No runtime deps