scolor

Crates.ioscolor
lib.rsscolor
version8.0.0
sourcesrc
created_at2021-10-17 09:05:20.012373
updated_at2021-12-24 10:10:15.994524
descriptionSimple ansi colors
homepage
repositoryhttps://github.com/sigmaSd/scolor
max_upload_size
id466158
size16,769
(sigmaSd)

documentation

README

scolor

Simple Ansi Colors (strives for ~=0 cost)

use scolor::ColorExt;
println!("{}", "hello".red().bold().underline());
println!("{}", "world".green().red_bg().italic());

use scolor::{Color, CustomStyle, ColorDesc, Effect};
const LIGHT_BLUE_ITALIC_BOLD: CustomStyle<2, 2> =
([ColorDesc::light_blue(), ColorDesc::red_bg()], [Effect::Italic, Effect::Bold]);

println!("{}", "world".custom(LIGHT_BLUE_ITALIC_BOLD));

Const equivalent of trait functions are provided as freestanding top-level functions

const BLUE_WORLD: scolor::ColorFmt<'_,str,1,0> = scolor::blue("world");

For even more zero cost power you can enable zero-cost feature

It makes the generated ASCII code as optimal as it can be

But the cost is that it's less ergonomic, the API is invoked like this:

use scolor::ColorExt;
println!("{}", "hello".green().bold::<1>().red_bg::<2>().italic::<2>());

use scolor::{ColorDesc, ColorFmt, Effect, green};
const _:() = {
    let fmt = green("hello").italic::<1>().bold::<2>().red_bg::<2>().crossed_out::<3>();
    assert!(matches!(ColorFmt{fmt:"hello",color:[ColorDesc::green(),ColorDesc::red_bg()],effect:[Effect::Italic, Effect::Bold]}, fmt));
};

License: MIT

Commit count: 36

cargo fmt