beautiful-md 0.3.3

A CLI tool to format and beautify Markdown files
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Terminal color utilities for beautiful-md CLI output.
//!
//! Provides consistent color styling with automatic TTY detection and `NO_COLOR` support.

use owo_colors::{OwoColorize, Stream};

/// Style for success messages (green).
pub fn success(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stdout, |t| t.green())
    )
}

/// Style for error messages (red).
pub fn error(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref().if_supports_color(Stream::Stderr, |t| t.red())
    )
}

/// Style for warning messages (yellow).
pub fn warning(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stderr, |t| t.yellow())
    )
}

/// Style for info messages (cyan).
pub fn info(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stderr, |t| t.cyan())
    )
}

/// Style for file paths (bright cyan).
pub fn path(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stderr, |t| t.bright_cyan())
    )
}

/// Style for line numbers (dimmed).
#[allow(dead_code)]
pub fn line_number(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stderr, |t| t.dimmed())
    )
}

/// Style for emphasis (bold).
#[allow(dead_code)]
pub fn bold(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stdout, |t| t.bold())
    )
}

/// Style for code snippets (dimmed).
#[allow(dead_code)]
pub fn snippet(text: impl AsRef<str>) -> String {
    format!(
        "{}",
        text.as_ref()
            .if_supports_color(Stream::Stderr, |t| t.dimmed())
    )
}

/// Set global color mode override.
///
/// This is used to implement the --no-color flag.
pub fn set_override(enabled: bool) {
    if !enabled {
        owo_colors::set_override(false);
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_color_functions_dont_panic() {
        // Colors might be disabled in test environment, but functions should work
        let _ = success("test");
        let _ = error("test");
        let _ = warning("test");
        let _ = info("test");
        let _ = path("test");
        let _ = line_number("test");
        let _ = bold("test");
        let _ = snippet("test");
    }

    #[test]
    fn test_set_override() {
        set_override(false);
        // Should not panic and should disable colors globally
        let result = success("test");
        assert_eq!(result, "test");
    }
}