kitest 0.5.0

A composable test harness toolkit with room to fly.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Color related utilities for formatters.

use std::io;

/// Controls whether colored output should be used by a formatter.
///
/// The actual decision may depend on the selected variant and the output target.
#[derive(Debug, Default, PartialEq, Eq, Clone, Copy)]
pub enum ColorSetting {
    /// Enable color only if the output target reports that it supports color.
    ///
    /// This is the default.
    #[default]
    Automatic,

    /// Always emit ANSI color codes, regardless of the target.
    Always,

    /// Never emit ANSI color codes.
    Never,
}

impl From<bool> for ColorSetting {
    fn from(value: bool) -> Self {
        match value {
            true => ColorSetting::Always,
            false => ColorSetting::Never,
        }
    }
}

pub(crate) mod colors {
    pub const RESET: &str = "\x1b(B\x1b[m";
    pub const RED: &str = "\x1b[31m";
    pub const GREEN: &str = "\x1b[32m";
    pub const YELLOW: &str = "\x1b[33m";
    pub const CYAN: &str = "\x1b[36m";
}

/// A small trait used to determine whether a writer supports colored output.
///
/// This is used together with [`ColorSetting::Automatic`] to heuristically
/// decide if ANSI color codes should be emitted.
pub trait SupportsColor {
    /// Return `true` if this target supports colored output.
    fn supports_color(&self) -> bool;
}

impl<T: io::IsTerminal> SupportsColor for T {
    fn supports_color(&self) -> bool {
        self.is_terminal()
    }
}