颜色

用于创建彩色控制台输出的宏。

通用

查看调色板

cargo run --example println

以下宏提供

所有这些宏都可以通过追加 _bold（例如 blue_ln_bold）以粗体格式使用。

以下宏使用默认前景颜色也是可用的

• print_bold！
• eprint_bold! 和 e_print_bold!
• println_bold! 和 print_ln_bold!
• eprintln_bold! 和 e_print_ln_bold!
• write_bold！
• writeln_bold！

配置

该包遵循 终端ANSI颜色标准 的建议，这意味着会尊重环境变量 NO_COLOR 和 CLICOLOR_FORCE。库会像 CLICOLOR 已设置一样行动，因此该环境变量没有效果。

也会考虑环境变量 TERM：如果设置为 dumb，则禁用彩色输出；如果设置为任何其他值，则启用彩色输出。

优先顺序是 NO_COLOR，然后是 CLICOLOR_FORCE，最后是 TERM。

在二进制文件中的使用

二进制文件可以通过调用 force_colour 或 force_no_colour 来覆盖这些环境变量和自动检测终端/tty。二进制文件应只调用这些函数中的一个，并且调用应发生在调用此包提供的任何宏之前。

库通常不应调用这些函数。

示例

use colour::*;

fn _foo() {
    let err: Result<(), u8> = Err(1);
    yellow_ln!("Failed on {}", 9);
    print!("Error details: ");
    dark_red_ln_bold!("{:?}", err);
}

fn main() {
    grey_ln!("grey");
    grey_ln_bold!("bold grey");
    dark_grey_ln!("dark grey");
    dark_grey_ln_bold!("bold dark grey");
    red_ln!("red");
    red_ln_bold!("bold red");
    dark_red_ln!("dark red");
    dark_red_ln_bold!("bold dark red");
    green_ln!("green");
    green_ln_bold!("bold green");
    dark_green_ln!("dark green");
    dark_green_ln_bold!("bold dark green");
    yellow_ln!("yellow");
    yellow_ln_bold!("bold yellow");
    dark_yellow_ln!("dark yellow");
    dark_yellow_ln_bold!("bold dark yellow");
    blue_ln!("blue");
    blue_ln_bold!("bold blue");
    dark_blue_ln!("dark blue");
    dark_blue_ln_bold!("bold dark blue");
    magenta_ln!("magenta");
    magenta_ln_bold!("bold magenta");
    dark_magenta_ln!("dark magenta");
    dark_magenta_ln_bold!("bold dark magenta");
    cyan_ln!("cyan");
    cyan_ln_bold!("bold cyan");
    dark_cyan_ln!("dark cyan");
    dark_cyan_ln_bold!("bold dark cyan");
    black_ln!("black");
    black_ln_bold!("bold black");
    white_ln!("white");
    white_ln_bold!("bold white");
    println!("default colour");
    println_bold!("bold default colour");
}

最小Rust版本

该包可以使用 Rust 版本 1.70.0 及更高版本编译。

许可证

colour 根据 MIT 许可证和 Apache 许可证（版本 2.0）的条款分发。

有关详细信息，请参阅 LICENSE-MIT 和 LICENSE-APACHE。