1 stable release
1.0.0 | Feb 5, 2025 |
---|
#267 in Command-line interface
138 downloads per month
13KB
259 lines
ino_color
A output coloring crate with limited functionality, limit platform support and limited allocations. It's perfect for scratching tiny spot of itch.
Examples
use ino_color::InoColor;
use ino_color::colors::*;
use ino_color::styles::*;
let msg = "Hello Fancy".fg::<Yellow>();
println!( "{msg}" );
// It's also chainable!
// Lifetime becomes annoying though.
let msg = "Savoy blue".fg::<Blue>();
let msg = msg.style::<Italic>();
println!( "{msg}" );
Pros & Cons
Pros
- Good at scratching itch.
- Low amount of allocations.
- Follows the Standard for ANSI Colors in Terminals by default.
- Doesn't pollute the LSP completion with dozens of methods named after colors.
Cons
-
Linux only.
- However it doesn't use platfor specific API, so it might also works on Darwin and modern Windows as long as the terminal emulator speaks ANSI SGR.
-
Can't set background color (yet?).
- Reason: After years of experience of using Linux, no legit usage of background colors has been encountered other than TUI frameworks. Remove it simplifies the implementation.
-
All color and style selections are done in type level, meaning coloring can't be changed at runtime.
- Such APIs will not be added in the near future.
- Blame
owo-colors
for inventing this API, explained next section.
About owo-colors
This implementation has similar interfaces with owo-colors, namely the using of generic to select color and styles.
owo-color
is good and slime, however its interface is bloated with "convenient" color methods,
90% out of which will never be called anyway. More over, the caller needs to jump some hoops and be explicit
about whether to enable colors (the if_supports_color
method), which is both good and bad.
ino_color
removes the runtime color selection support, in gain it has a even slimer API. And as stated in Pros,
it follows the ANSI color standard by default, although the various checks do introduce amounts of costs, so it's
recommended to cache the colored result, or use *_always
APIs to skip the check.