edikt-core 0.2.0

edikt core: value model, Feature capabilities, the expression language, and the Document/Convert seams.
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

//! Format capabilities.
//!
//! Each format module declares a static `&[Feature]`. The set is consulted at
//! edit time (an operation needing a feature the format lacks fails cleanly) and
//! at conversion time (each source-used feature the target lacks is a warning).

/// A capability a config format may or may not support.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Feature {
    /// Comments / trivia the CST preserves (JSONC, INI, `.env` - not plain JSON).
    Comments,
    /// Nested containers beyond a single level (JSON objects/arrays).
    Nesting,
    /// Ordered sequences.
    Arrays,
    /// Non-string scalars: numbers, booleans, null.
    TypedScalars,
    /// A single level of named grouping (INI `[section]`).
    Sections,
}

impl Feature {
    /// Human-readable name, used in conversion warnings.
    pub fn as_str(self) -> &'static str {
        match self {
            Feature::Comments => "comments",
            Feature::Nesting => "nesting",
            Feature::Arrays => "arrays",
            Feature::TypedScalars => "typed scalars",
            Feature::Sections => "sections",
        }
    }
}

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

    #[test]
    fn names() {
        assert_eq!(Feature::Comments.as_str(), "comments");
        assert_eq!(Feature::Nesting.as_str(), "nesting");
        assert_eq!(Feature::Arrays.as_str(), "arrays");
        assert_eq!(Feature::TypedScalars.as_str(), "typed scalars");
        assert_eq!(Feature::Sections.as_str(), "sections");
    }
}