toolstr 0.1.5

utilities for formatting data into String's
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

use unicode_truncate::{Alignment, UnicodeTruncateStr};

/// line count of String or &str
pub fn n_lines<T: AsRef<str>>(s: T) -> usize {
    s.as_ref().chars().filter(|&c| c == '\n').count()
}

/// width of String or &str
pub fn width<T: AsRef<str>>(s: T) -> usize {
    s.as_ref()
        .split('\n')
        .map(|s| s.chars().count())
        .max()
        .unwrap_or(0)
    // .map(unicode_width::UnicodeWidthStr::width)
    // .map(unicode_width::UnicodeWidthStr::width_cjk)
}

/// width of a single line
pub fn line_width<T: AsRef<str>>(s: T) -> usize {
    s.as_ref().chars().count()
}

/// lines of String or &str
pub fn lines<T: AsRef<str>>(s: T) -> Vec<String> {
    s.as_ref().split('\n').map(|s| s.to_string()).collect()
}

/// multiline align left
pub fn align_left<T: AsRef<str>>(s: T, width: usize) -> String {
    s.as_ref()
        .split('\n')
        .map(|s| align_line_left(s, width))
        .collect::<Vec<_>>()
        .join("\n")
}

/// multiline align right
pub fn align_right<T: AsRef<str>>(s: T, width: usize) -> String {
    s.as_ref()
        .split('\n')
        .map(|s| align_line_right(s, width))
        .collect::<Vec<_>>()
        .join("\n")
}

/// align single line left
pub fn align_line_left<T: AsRef<str>>(s: T, width: usize) -> String {
    s.as_ref().unicode_pad(width, Alignment::Left, false).into()
}

/// align single line right
pub fn align_line_right<T: AsRef<str>>(s: T, width: usize) -> String {
    s.as_ref()
        .unicode_pad(width, Alignment::Right, false)
        .into()
}