mant-protocol 0.11.0

Transport-neutral query contracts and projections for ManT
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

//! Stable business labels, independent of styling or terminal presentation.

use mant_ir::{EntryKind, ParameterKind};

/// Stable human label, distinct from Rust Debug and from wire discriminators.
#[must_use]
pub const fn entry_kind_label(kind: EntryKind) -> &'static str {
    match kind {
        EntryKind::Parameter {
            parameter_kind: ParameterKind::Option,
        } => "option",
        EntryKind::Parameter {
            parameter_kind: ParameterKind::Marker,
        } => "marker",
        EntryKind::Parameter {
            parameter_kind: ParameterKind::Operand,
        } => "operand",
        EntryKind::Command => "command",
        EntryKind::EnvironmentVariable => "environment variable",
        EntryKind::ConfigurationKey => "configuration key",
        EntryKind::Variable => "variable",
        EntryKind::Value => "value",
        EntryKind::Term => "term",
    }
}

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

    #[test]
    fn all_nine_kinds_have_labels_without_conflating_parameters() {
        let kinds = [
            (
                EntryKind::Parameter {
                    parameter_kind: ParameterKind::Option,
                },
                "option",
            ),
            (
                EntryKind::Parameter {
                    parameter_kind: ParameterKind::Marker,
                },
                "marker",
            ),
            (
                EntryKind::Parameter {
                    parameter_kind: ParameterKind::Operand,
                },
                "operand",
            ),
            (EntryKind::Command, "command"),
            (EntryKind::EnvironmentVariable, "environment variable"),
            (EntryKind::ConfigurationKey, "configuration key"),
            (EntryKind::Variable, "variable"),
            (EntryKind::Value, "value"),
            (EntryKind::Term, "term"),
        ];
        for (kind, label) in kinds {
            assert_eq!(entry_kind_label(kind), label);
        }
    }
}