lysutil 0.1.1

Various utilities created by Lys/Rax for personal use. You may find them helpful.
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
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

//! Prettifies Vec-s

use std::fmt::{Debug, Display};
use string_builder::Builder;

/// Returns a given Vec<T: Display> as a String, prettified.
///
/// # Arguments
///
/// * `v` - a Vec<T: Display> to prettify
///
/// # Remarks
///
/// There is a `pretty_vec_debug` for items that implement Debug, but not Display
///
/// # Example
/// ```rust
/// # use std::error::Error;
/// use lysutil::pretty::pretty_vec;
/// #
/// # fn main() -> Result<(), Box<dyn Error>> {
/// let vec = vec![1, 5, 2, 44, 18272]; // Contents of the Vec must implement std::fmt::Display
/// let pretty = pretty_vec(vec);
/// #   Ok(())
/// # }
/// ```
pub fn pretty_vec<T>(v: Vec<T>) -> String
where
    T: Display,
{
    if v.len() > 1 {
        let mut b = Builder::default();
        b.append("[");
        let mut iters = 0;
        for x in &v {
            if iters < v.len() - 1 {
                b.append(format!("{}, ", *x));
                iters += 1;
            } else {
                b.append(format!("{}", *x));
            }
        }

        b.append("]");
        b.string().unwrap()
    } else if v.len() == 1 {
        format!("[{}]", v[0])
    } else {
        format!("[]")
    }
}

/// Returns a given Vec<T: Debug> as a String, prettified.
///
/// # Arguments
///
/// * `v` - a Vec<T: Debug> to prettify
///
/// # Remarks
///
/// There is a `pretty_vec` for items that implement Display, but not Debug
///
/// # Example
/// ```rust
/// # use std::error::Error;
/// use lysutil::pretty::pretty_vec_debug;
/// #
/// # fn main() -> Result<(), Box<dyn Error>> {
/// let vec = vec![1, 5, 2, 44, 18272]; // Contents of the Vec must implement std::fmt::Debug
/// let pretty = pretty_vec_debug(vec);
/// #   Ok(())
/// # }
/// ```
pub fn pretty_vec_debug<T>(v: Vec<T>) -> String
where
    T: Debug,
{
    if v.len() > 1 {
        let mut b = Builder::default();
        b.append("[");
        let mut iters = 0;
        for x in &v {
            if iters < v.len() - 1 {
                b.append(format!("{:?}, ", *x));
                iters += 1;
            } else {
                b.append(format!("{:?}", *x));
            }
        }

        b.append("]");
        b.string().unwrap()
    } else if v.len() == 1 {
        format!("[{:?}]", v[0])
    } else {
        format!("[]")
    }
}