streampager 0.10.3

streampager is a pager for command output or large 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

//! Utilities.

use std::borrow::Cow;

use unicode_segmentation::UnicodeSegmentation;
use unicode_width::UnicodeWidthStr;

/// Returns the maximum width in characters of a number.
pub(crate) fn number_width(number: usize) -> usize {
    let mut width = 1;
    let mut limit = 10;
    while limit <= number {
        limit *= 10;
        width += 1;
    }
    width
}

/// Truncates a string to a column offset and width.
pub(crate) fn truncate_string<'a>(
    text: impl Into<Cow<'a, str>>,
    offset: usize,
    width: usize,
) -> String {
    let text = text.into();
    if offset > 0 || width < text.width() {
        let mut column = 0;
        let mut maybe_start_index = None;
        let mut maybe_end_index = None;
        let mut start_pad = 0;
        let mut end_pad = 0;
        for (i, g) in text.grapheme_indices(true) {
            let w = g.width();
            if w != 0 {
                if column >= offset && maybe_start_index.is_none() {
                    maybe_start_index = Some(i);
                    start_pad = column - offset;
                }
                if column + w > offset + width && maybe_end_index.is_none() {
                    maybe_end_index = Some(i);
                    end_pad = offset + width - column;
                    break;
                }
                column += w;
            }
        }
        let start_index = maybe_start_index.unwrap_or_else(|| text.len());
        let end_index = maybe_end_index.unwrap_or_else(|| text.len());
        format!(
            "{0:1$.1$}{3}{0:2$.2$}",
            "",
            start_pad,
            end_pad,
            &text[start_index..end_index]
        )
    } else {
        text.into_owned()
    }
}