colour 1.0.0

Macros for creating coloured console output.
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

use std::{
    fmt::Arguments,
    io::{self, Write},
};

use crossterm::{
    self,
    style::{Color, SetForegroundColor},
    QueueableCommand,
};

pub type Colour = Color;

pub fn write<T: Write, const NEWLINE: bool>(
    output: T,
    output_name: &'static str,
    colour: Colour,
    maybe_args: Option<Arguments>,
) {
    if let Err(error) = do_write::<T, NEWLINE>(output, colour, maybe_args) {
        panic!("failed writing to {output_name}: {error}");
    }
}

fn do_write<T: Write, const NEWLINE: bool>(
    mut output: T,
    colour: Colour,
    maybe_args: Option<Arguments>,
) -> io::Result<()> {
    let _ = output.queue(SetForegroundColor(colour))?;

    if let Some(args) = maybe_args {
        output.write_fmt(args)?;
    }

    if NEWLINE {
        writeln!(output)?;
    }

    let _ = output.queue(SetForegroundColor(Colour::Reset))?;
    output.flush()
}