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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

//! Terminal coloring
//!
//! The Texcraft project uses the
//! [Colored crate](https://docs.rs/colored/latest/colored/) for terminal coloring.
//! However, per [Texcraft's dependency policy](https://texcraft.dev/governance/dependencies.html),
//! use of this crate must be behind a Cargo feature.
//! In the case of Colored, the Cargo feature is `color`.
//!
//! This module implements the Cargo feature.
//!
//! The module contains a single trait [`Colorize`].
//! When the Cargo feature is enabled, this trait is essentially identical to
//!     the Colored crate's `Colorize` trait.
//! Specifically, it just forwards all method calls to the Colored crate.
//! When the Cargo feature is disabled, the trait is a no-op.
//! In both cases, downstream code can just call methods on the trait:
//!
//! ```
//! use texcraft_stdext::color::Colorize;
//! println!["{}", "Hello, World".bold().bright_red()];
//! ```

#[cfg(feature = "color")]
pub type ColoredString = colored::ColoredString;

#[cfg(not(feature = "color"))]
pub type ColoredString = &str;

macro_rules! colorize_impl {
    ( $( $method_name: ident, )+ ) => {
        /// Trait that provides coloring methods on strings.
        ///
        /// See the module documentation for information.
        pub trait Colorize {
            $(
                fn $method_name(self) -> ColoredString;
            )+
        }
        #[cfg(feature="color")]
        impl Colorize for ColoredString {
            $(
                fn $method_name(self) -> ColoredString {
                    colored::Colorize::$method_name(self)
                }
            )+
        }
        #[cfg(feature="color")]
        impl Colorize for &str {
            $(
                fn $method_name(self) -> ColoredString {
                    colored::Colorize::$method_name(self)
                }
            )+
        }
        #[cfg(not(feature="color"))]
        impl Colorize for &str {
            $(
                fn $method_name(self) -> ColoredString {
                    self
                }
            )+
        }

    };
}

colorize_impl!(
    bold,
    bright_cyan,
    bright_blue,
    bright_red,
    bright_yellow,
    italic,
);