compose-lens 0.1.16

Loss-aware parsing, processing, validation, and rendering of Compose projects
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

//! Raw-preserving service real-time CPU-period values.

use super::lifecycle::valid_stop_grace_period;

/// A service `cpu_rt_period` scalar category with exact authored spelling.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum CpuRtPeriod {
    /// A YAML numeric scalar retained without conversion or normalization.
    YamlNumber(String),
    /// A raw Compose duration retained without conversion or normalization.
    Duration(String),
    /// A dollar-bearing string retained as a deferred expression.
    Expression(String),
    /// A schema-valid string outside the duration policy, retained with a diagnostic.
    Other(String),
}

impl CpuRtPeriod {
    pub(crate) fn parse_string(value: String) -> Self {
        if value.contains('$') {
            Self::Expression(value)
        } else if valid_stop_grace_period(value.trim_end_matches(['\r', '\n'])) {
            Self::Duration(value)
        } else {
            Self::Other(value)
        }
    }

    pub(crate) const fn is_valid(&self) -> bool {
        !matches!(self, Self::Other(_))
    }
}

#[cfg(test)]
mod tests {
    use super::CpuRtPeriod;

    #[test]
    fn classifies_duration_expression_and_other_spellings() {
        for value in ["1us", "1m30s", "1.5s", ".5s"] {
            assert!(matches!(
                CpuRtPeriod::parse_string(value.to_owned()),
                CpuRtPeriod::Duration(actual) if actual == value
            ));
        }
        assert!(matches!(
            CpuRtPeriod::parse_string("1m30s\n".to_owned()),
            CpuRtPeriod::Duration(value) if value == "1m30s\n"
        ));
        assert!(matches!(
            CpuRtPeriod::parse_string("${CPU_RT_PERIOD}".to_owned()),
            CpuRtPeriod::Expression(value) if value == "${CPU_RT_PERIOD}"
        ));
        for value in ["", "1", "1ns", "1µs", "1μs", "1.s"] {
            assert!(matches!(
                CpuRtPeriod::parse_string(value.to_owned()),
                CpuRtPeriod::Other(actual) if actual == value
            ));
        }
    }
}