kinjo 0.2.0

Kinjo: mDNS TUI and commands launch for local network services
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

//! Terminal presentation for text written by Kinjo itself.
//!
//! Values stay raw in discovery, matching, configuration, and command argv.
//! Every renderer and process-owned output path crosses this module only when
//! it is ready to turn a value into terminal bytes.

use std::fmt::Write as _;
use unicode_width::UnicodeWidthStr;

/// Return `value` with Unicode control characters replaced by visible escapes.
///
/// C0, DEL, and C1 controls fit in a byte and use `\xNN`; any future control
/// outside that range uses Rust-like `\u{...}` notation. Printable Unicode,
/// including combining and bidirectional-formatting characters, is unchanged.
pub(crate) fn text(value: &str) -> String {
    let mut output = String::with_capacity(value.len());
    for character in value.chars() {
        if !character.is_control() {
            output.push(character);
            continue;
        }

        let codepoint = character as u32;
        if codepoint <= u8::MAX as u32 {
            // Writing to a String cannot fail.
            write!(output, "\\x{codepoint:02X}").expect("writing to a String cannot fail");
        } else {
            write!(output, "\\u{{{codepoint:X}}}").expect("writing to a String cannot fail");
        }
    }
    output
}

/// Number of terminal display columns occupied by already-safe text.
pub(crate) fn width(value: &str) -> usize {
    UnicodeWidthStr::width(value)
}

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

    #[test]
    fn controls_are_visible_and_printable_unicode_is_unchanged() {
        assert_eq!(
            text("\0\u{7}\t\n\r\u{1b}\u{7f}\u{80}\u{85}\u{9f}"),
            "\\x00\\x07\\x09\\x0A\\x0D\\x1B\\x7F\\x80\\x85\\x9F"
        );

        let printable = "café 界 e\u{301} 🙂 \u{202e}";
        assert_eq!(text(printable), printable);
    }
}