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
use serde::{
Deserialize,
Serialize,
};
use crate::data::catalog::document::{
MergeMode,
TypeExpr,
};
/// A tag declaration.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct TagEntry {
/// The tag's own segment.
#[serde(skip)]
pub name: String,
/// How this occurrence meets an existing declaration of its name.
#[serde(rename = "$merge", default, skip_serializing_if = "MergeMode::is_deny")]
pub merge: MergeMode,
/// What the tag says, for a person.
#[serde(rename = "$description")]
pub description: String,
/// The values the tag takes.
#[serde(rename = "$type")]
pub tag_type: TypeExpr,
}
/// An axis's kind.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum AxisKind {
/// Two generated members, `X` and `no-X`, for the axis `X`, with a
/// negation between them.
Bool,
/// Declared members, which may grow; no negation.
Categorical,
}
/// An axis declaration. It is also the declaration of the tag the axis
/// implies on every build that uses it.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct AxisEntry {
/// The axis's own segment. A bool axis's positive member has this name.
#[serde(skip)]
pub name: String,
/// How this occurrence meets an existing declaration of its name.
#[serde(rename = "$merge", default, skip_serializing_if = "MergeMode::is_deny")]
pub merge: MergeMode,
/// What the axis selects, for a person.
#[serde(rename = "$description")]
pub description: String,
/// The axis's kind.
#[serde(rename = "$axis")]
pub axis: AxisKind,
/// A categorical axis's members; a bool axis has none written.
#[serde(rename = "$members", default, skip_serializing_if = "Vec::is_empty")]
pub members: Vec<String>,
}
impl AxisEntry {
/// The axis's members: the declared ones, or `[X, no-X]` for a bool
/// axis `X`.
pub fn member_names(&self) -> Vec<String> {
match self.axis {
AxisKind::Bool => vec![self.name.clone(), format!("no-{}", self.name)],
AxisKind::Categorical => self.members.clone(),
}
}
/// The negation of `member` on a bool axis; `None` on a categorical
/// axis or for a non-member.
pub fn negate(
&self,
member: &str,
) -> Option<String> {
if self.axis != AxisKind::Bool {
return None;
}
let negative = format!("no-{}", self.name);
if member == self.name {
Some(negative)
} else if member == negative {
Some(self.name.clone())
} else {
None
}
}
}
/// A facet declaration: a named, exclusive set of groups. A build is in at
/// most one group of each facet.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct FacetEntry {
/// The facet's name; facets are top-level only.
#[serde(skip)]
pub name: String,
/// How this occurrence meets an existing declaration of its name.
#[serde(rename = "$merge", default, skip_serializing_if = "MergeMode::is_deny")]
pub merge: MergeMode,
/// What the facet sorts groups by, for a person.
#[serde(rename = "$description")]
pub description: String,
}