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
113
114
115
116

//! Contains the [Config] super trait, and all the sub traits required by it
//!
//! Implementing the [Config] super trait is required by configs passed to structs in other modules as part of instantiation.

use crate::util::*;

// Styles for the help message
pub(crate) fn styles() -> Styles {
    Styles::styled()
        .usage(AnsiColor::Yellow.on_default() | Effects::BOLD | Effects::ITALIC)
        .header(AnsiColor::BrightMagenta.on_default() | Effects::BOLD | Effects::UNDERLINE)
        .literal(AnsiColor::Green.on_default() | Effects::BOLD)
        .placeholder(AnsiColor::BrightCyan.on_default())
}

/// Super trait for all the traits that needed to be implemented by the config struct
// Generic traits that are required by the config struct
pub trait Config: Send + Sync + Sized
where
    // Subtraits that group together related configuration options
    Self: UtilOpt + FilterOpt + InputOutputOpt + ChecksOpt + ViewOpt + CustomChecksOpt,
{
    /// Validate the arguments of the config
    fn validate_args(&self) -> Result<(), String> {
        if let Some(check) = self.check() {
            if let Some(target) = check.target() {
                if matches!(check, CheckCommands::Sanity(_)) && target == System::ITS_Stave {
                    return Err("Invalid config: Cannot check ITS stave with `check sanity`, instead use `check all its-stave`".to_string());
                }
                if !matches!(target, System::ITS_Stave) && self.check_its_trigger_period().is_some()
                {
                    return Err("Invalid config: Specifying trigger period has to be done with the `check all its-stave` command".to_string());
                }
            } else {
                // All the illegal options when a check target is not specified
                if self.check_its_trigger_period().is_some() {
                    return Err("Invalid config: Specifying trigger period has to be done with the `check all its-stave` command".to_string());
                }
            }
        } else {
            // All the illegal options when checks are not enabled
            if self.check_its_trigger_period().is_some() {
                return Err("Invalid config: Specifying trigger period has to be done with the `check all its-stave` command".to_string());
            }
        }
        if self.any_errors_exit_code().is_some_and(|val| val == 0) {
            return Err("Invalid config: Exit code for any errors cannot be 0".to_string());
        }
        // Validate input stats file
        if let Some(path_str) = self.input_stats_file() {
            if !path_str.is_file() {
                return Err(format!(
                    "Invalid config: Input stats file does not exist (got: {})",
                    path_str.to_string_lossy()
                ));
            } else if path_str.extension().is_none() {
                return Err(format!(
                    "Invalid config: Input stats file has no extension (got: {})",
                    path_str.to_string_lossy()
                ));
            } else if path_str.extension().unwrap() != "json"
                && path_str.extension().unwrap() != "toml"
            {
                return Err(format!(
                    "Invalid config: Input stats file has invalid extension, should be JSON or TOML, got: {})",
                    path_str.to_string_lossy()
                ));
            }
        }
        Ok(())
    }

    /// Check if the config has the `check all its-stave` command set, which is currently the only way to enable ALPIDE checks
    fn alpide_checks_enabled(&self) -> bool {
        self.check()
            .is_some_and(|c| c.target().is_some_and(|s| s == System::ITS_Stave))
    }
}

impl<T> Config for &T
where
    T: Config,
{
    fn validate_args(&self) -> Result<(), String> {
        (*self).validate_args()
    }

    fn alpide_checks_enabled(&self) -> bool {
        (*self).alpide_checks_enabled()
    }
}

impl<T> Config for Box<T>
where
    T: Config,
{
    fn validate_args(&self) -> Result<(), String> {
        (**self).validate_args()
    }

    fn alpide_checks_enabled(&self) -> bool {
        (**self).alpide_checks_enabled()
    }
}
impl<T> Config for Arc<T>
where
    T: Config,
{
    fn validate_args(&self) -> Result<(), String> {
        (**self).validate_args()
    }

    fn alpide_checks_enabled(&self) -> bool {
        (**self).alpide_checks_enabled()
    }
}