malevich 0.7.0

Terminal plotting: a small grammar of marks, honest axes, millions of points
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

//! Display-width measurement and fitting for text on the cell grid.
//!
//! Labels are measured in terminal columns, not chars: CJK and other wide glyphs
//! occupy two cells. Zero-width characters (combining marks) do not survive the cell
//! grid — one cell holds one glyph — and are dropped at the boundary.

use unicode_width::UnicodeWidthChar;

/// The display width of `text` in terminal columns.
pub(crate) fn display_width(text: &str) -> usize {
    text.chars().map(|glyph| glyph.width().unwrap_or(0)).sum()
}

/// Fits `text` into at most `max` columns, truncating with `ellipsis` when needed.
pub(crate) fn fit_width_with(text: &str, max: usize, ellipsis: char) -> String {
    if display_width(text) <= max {
        return text.to_string();
    }
    let mut out = String::new();
    let mut used = 0;
    for glyph in text.chars() {
        let width = glyph.width().unwrap_or(0);
        if used + width > max.saturating_sub(1) {
            break;
        }
        out.push(glyph);
        used += width;
    }
    if max >= 1 {
        out.push(ellipsis);
    }
    out
}

#[cfg(test)]
#[path = "tests/width_tests.rs"]
mod tests;