c-shell 0.3.1

An interactive shell for C: type an expression, a statement or a function and see what your real compiler does with it
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
115
116
117
118
119
120
121
122
123
124

//! Terminal styling, centralised so `--no-color` has one switch to flip.

use crate::i18n::Language;

pub struct Ui {
    pub color: bool,
    /// Whether stdout is an interactive terminal that can consume terminal
    /// control sequences. OSC 8 is ignored by terminals that do not implement
    /// hyperlinks, while the linked URL remains visible as ordinary text.
    pub hyperlinks: bool,
    pub language: Language,
}

/// Startup banner, slant style. Kept under 60 columns so it survives
/// narrow terminals without wrapping.
const BANNER: &str = r#"   ______          _____    __  __    ______    __     __
  / ____/         / ___/   / / / /   / ____/   / /    / /
 / /      _____   \__ \   / /_/ /   / __/     / /    / /
/ /___   /_____/ ___/ /  / __  /   / /___    / /___ / /___
\____/          /____/  /_/ /_/   /_____/   /_____//_____/
"#;

impl Ui {
    pub fn text(&self, key: &str) -> String {
        crate::i18n::text_for(self.language, key)
    }

    pub fn text_with(&self, key: &str, values: &[(&'static str, String)]) -> String {
        crate::i18n::text_with_for(self.language, key, values)
    }

    fn paint(&self, code: &str, s: &str) -> String {
        if self.color {
            format!("\x1b[{code}m{s}\x1b[0m")
        } else {
            s.to_string()
        }
    }

    /// The startup ASCII art, colored when the terminal is.
    pub fn banner(&self) -> String {
        self.paint("1;36", BANNER)
    }

    /// The plain `In [n]:` prompt label, without the trailing space or color;
    /// reedline draws it and supplies both. Single source of truth for the
    /// prompt text, shared with [`Ui::prompt_width`].
    pub fn prompt_label(n: usize) -> String {
        format!("In [{n}]:")
    }

    /// Printable width of the full prompt (`In [n]: `, label plus its trailing
    /// space) — the column where the user's code starts, and the width the
    /// continuation-line indicator is padded to.
    pub fn prompt_width(n: usize) -> usize {
        Self::prompt_label(n).len() + 1
    }

    pub fn out_label(&self, n: usize) -> String {
        self.paint("1;31", &format!("Out[{n}]: "))
    }

    /// Marker shown only when c-shell, rather than the C program, has to end
    /// a partial terminal line before printing diagnostics, a value or prompt.
    pub fn inserted_newline_marker(&self) -> String {
        self.dim("↵")
    }

    pub fn err(&self, s: &str) -> String {
        self.paint("31", s)
    }

    pub fn warn(&self, s: &str) -> String {
        self.paint("33", s)
    }

    pub fn dim(&self, s: &str) -> String {
        self.paint("2", s)
    }

    pub fn bold(&self, s: &str) -> String {
        self.paint("1", s)
    }

    /// Make a visible URL clickable in terminals that implement OSC 8.
    ///
    /// Keeping the URL itself as the label means transcripts and terminals
    /// without hyperlink support still expose a useful address.
    pub fn hyperlink(&self, url: &str) -> String {
        if self.hyperlinks {
            format!("\x1b]8;;{url}\x1b\\{url}\x1b]8;;\x1b\\")
        } else {
            url.to_string()
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::i18n::Language;

    use super::Ui;

    #[test]
    fn hyperlinks_keep_the_url_visible_in_both_rendering_modes() {
        let url = "https://en.cppreference.com/c/header/stdio";
        let plain = Ui {
            color: false,
            hyperlinks: false,
            language: Language::English,
        };
        assert_eq!(plain.hyperlink(url), url);

        let interactive = Ui {
            color: false,
            hyperlinks: true,
            language: Language::English,
        };
        assert_eq!(
            interactive.hyperlink(url),
            format!("\x1b]8;;{url}\x1b\\{url}\x1b]8;;\x1b\\")
        );
    }
}