fastpasta 1.22.0

CLI for verifying or examining readout data from the ALICE detector.
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use owo_colors::OwoColorize;

/// Used for formatting fields that potentially produces many values.
const MAX_LINE_WIDTH: usize = 60;

/// Format a size in bytes to human readable.
pub(crate) fn format_data_size(size_bytes: u64) -> String {
    match size_bytes {
        0..=1024 => format!("{} B", size_bytes),
        1025..=1048576 => {
            format!("{:.2} KiB", size_bytes as f64 / 1024_f64)
        }
        1048577..=1073741824 => {
            format!("{:.2} MiB", size_bytes as f64 / 1048576_f64)
        }
        _ => format!("{:.2} GiB", size_bytes as f64 / 1073741824_f64),
    }
}

/// Sort and format links observed
pub(crate) fn format_links_observed(links_observed: &[u8]) -> String {
    links_observed
        .iter()
        .map(|x| x.to_string())
        .collect::<Vec<String>>()
        .join(", ")
}

/// Sort and format layers and staves seen
pub(crate) fn format_layers_and_staves(
    mut layers_staves_seen: Vec<(u8, u8)>,
    mut layers_stave_with_errors: Vec<(u8, u8)>,
) -> String {
    if layers_staves_seen.is_empty() {
        return "none".red().to_string();
    }
    layers_staves_seen.sort_unstable();
    layers_stave_with_errors.sort_unstable();

    let mut line_width = 0;
    layers_staves_seen
        .iter()
        .map(|(layer, stave)| {
            if layers_stave_with_errors.contains(&(*layer, *stave)) {
                format!("L{layer}_{stave} ").red().to_string()
            } else {
                format!("L{layer}_{stave} ").white().to_string()
            }
        })
        .fold(String::new(), |mut acc_str, stave_str| {
            // This is weird cause it's colored strings.
            // We need to map the length of the string to the string when it is displayed.
            // The length of the strings of form 'Lx_y ' is 15
            // The length of the strings of form 'Lx_yz ' is 16
            // So now we map 15 to 5 and 16 to 6 (+1 for whitespace)
            let current_str_len = stave_str.len() - 10;
            if line_width + current_str_len > MAX_LINE_WIDTH {
                acc_str.push('\n');
                line_width = 0;
            }
            line_width += current_str_len;
            acc_str.push_str(&stave_str);
            acc_str
        })
}

pub(crate) fn format_fee_ids(fee_ids_seen: &[u16]) -> String {
    if fee_ids_seen.is_empty() {
        return "none".red().to_string();
    }
    let mut fee_ids_seen = fee_ids_seen.to_owned();
    fee_ids_seen.sort_unstable();
    format_nums_max_lines_width(MAX_LINE_WIDTH as u16, Some(5), &fee_ids_seen)
}

pub(crate) fn format_error_codes(error_codes: &[String]) -> String {
    error_codes
        .iter()
        .enumerate()
        .map(|(i, code)| {
            if i > 0 && i % 5 == 0 {
                format!("E{code}\n")
            } else {
                format!("E{code} ")
            }
        })
        .collect()
}

/// Generic function to format a list of numbers into a string with a max width and optional max lines.
pub fn format_nums_max_lines_width(max_width: u16, max_lines: Option<u16>, nums: &[u16]) -> String {
    let mut result = String::new();
    let mut num_chars = 0;
    let mut line_count = 0;
    for (i, id) in nums.iter().enumerate() {
        if max_lines.is_some_and(|max_lines_count| line_count >= max_lines_count) {
            result.push_str(&format!("... {} more", nums.len() - i).yellow().to_string());
            break;
        }
        // How many characters will this id take up?
        let tmp_num_chars: u16 = id.checked_ilog10().unwrap_or(0) as u16 + 2; // +1 for whitespace and +1 for the first character
        if num_chars + tmp_num_chars > max_width {
            result.push_str(&format!("\n{id} ", id = id).white().to_string());
            num_chars = tmp_num_chars;
            line_count += 1;
        } else {
            result.push_str(&format!("{id} ", id = id).white().to_string());
            num_chars += tmp_num_chars;
        }
    }
    result
}