compose-lens 0.1.14

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
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

//! Raw-preserving service lifecycle controls.

/// A service stop grace period retained before interpolation.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum StopGracePeriod {
    /// A duration accepted by `ComposeLens`'s raw-preserving policy, with its spelling retained.
    Value(String),
    /// An interpolation-shaped scalar classified by the existing dollar-marker convention.
    Expression(String),
    /// An invalid or provider-specific scalar retained for diagnostics.
    Other(String),
}

impl StopGracePeriod {
    pub(crate) fn parse(value: String) -> Self {
        if value.contains('$') {
            Self::Expression(value)
        } else if valid_stop_grace_period(&value) {
            Self::Value(value)
        } else {
            Self::Other(value)
        }
    }

    /// Reports whether this is accepted by the raw-preserving policy or is interpolation-shaped.
    #[must_use]
    pub const fn is_valid(&self) -> bool {
        !matches!(self, Self::Other(_))
    }

    /// Returns the retained scalar spelling.
    #[must_use]
    pub fn raw(&self) -> &str {
        match self {
            Self::Value(value) | Self::Expression(value) | Self::Other(value) => value,
        }
    }
}

pub(crate) fn valid_stop_grace_period(mut value: &str) -> bool {
    let mut found = false;
    while !value.is_empty() {
        let number_end = value
            .char_indices()
            .take_while(|(_, character)| character.is_ascii_digit() || *character == '.')
            .map(|(index, character)| index + character.len_utf8())
            .last()
            .unwrap_or(0);
        if number_end == 0 {
            return false;
        }
        let number = &value[..number_end];
        if number.matches('.').count() > 1 || number == "." || number.ends_with('.') {
            return false;
        }
        value = &value[number_end..];
        let Some(unit) = ["us", "ms", "s", "m", "h"]
            .into_iter()
            .find(|unit| value.starts_with(unit))
        else {
            return false;
        };
        value = &value[unit.len()..];
        found = true;
    }
    found
}

#[cfg(test)]
mod tests {
    use super::{StopGracePeriod, valid_stop_grace_period};

    #[test]
    fn applies_the_raw_preserving_policy_using_documented_compose_units() {
        for value in ["1us", "1ms", "1s", "1m", "1h", "1m30s", "0s", "1.5s", ".5s"] {
            assert!(valid_stop_grace_period(value), "expected valid duration {value}");
        }
        for value in ["", "0", "1", "1ns", "1µs", "1μs", "1d", "s", ".s", "1.s", "1..5s"] {
            assert!(!valid_stop_grace_period(value), "expected invalid duration {value}");
        }
    }

    #[test]
    fn retains_valid_expression_and_other_spelling() {
        assert_eq!(
            StopGracePeriod::parse("1m30s".to_owned()),
            StopGracePeriod::Value("1m30s".to_owned())
        );
        assert_eq!(
            StopGracePeriod::parse("${STOP_GRACE_PERIOD:-1s}".to_owned()),
            StopGracePeriod::Expression("${STOP_GRACE_PERIOD:-1s}".to_owned())
        );
        assert_eq!(
            StopGracePeriod::parse("1ns".to_owned()),
            StopGracePeriod::Other("1ns".to_owned())
        );
    }

    #[test]
    fn uses_the_existing_dollar_marker_as_a_lexical_expression_classification() {
        assert_eq!(
            StopGracePeriod::parse("literal$5".to_owned()),
            StopGracePeriod::Expression("literal$5".to_owned())
        );
    }
}