1use std::fmt;
8use std::str::FromStr;
9
10#[derive(Debug, Clone, thiserror::Error, PartialEq, Eq)]
13#[error("unknown {kind} code: {value}")]
14pub struct UnknownCode {
15 pub kind: &'static str,
16 pub value: String,
17}
18
19macro_rules! code_enum {
20 (
21 $(#[$attr:meta])*
22 $vis:vis enum $name:ident as $kind:literal {
23 $(
24 $(#[$variant_attr:meta])*
25 $variant:ident => $wire:literal
26 ),+ $(,)?
27 }
28 ) => {
29 $(#[$attr])*
30 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
31 $vis enum $name {
32 $(
33 $(#[$variant_attr])*
34 $variant,
35 )+
36 }
37
38 impl $name {
39 #[must_use]
41 pub const fn as_str(self) -> &'static str {
42 match self {
43 $( Self::$variant => $wire, )+
44 }
45 }
46
47 #[must_use]
49 pub const fn all() -> &'static [Self] {
50 &[ $( Self::$variant, )+ ]
51 }
52 }
53
54 impl fmt::Display for $name {
55 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
56 f.write_str(self.as_str())
57 }
58 }
59
60 impl FromStr for $name {
61 type Err = UnknownCode;
62 fn from_str(s: &str) -> Result<Self, Self::Err> {
63 Ok(match s {
64 $( $wire => Self::$variant, )+
65 other => return Err(UnknownCode {
66 kind: $kind,
67 value: other.to_string(),
68 }),
69 })
70 }
71 }
72 };
73}
74
75code_enum! {
76 pub enum Role as "role" {
78 Doc => "doc",
79 Btn => "btn",
80 Lnk => "lnk",
81 Tf => "tf",
82 Ta => "ta",
83 Sel => "sel",
84 Chk => "chk",
85 Rad => "rad",
86 Img => "img",
87 Hd => "hd",
88 P => "p",
89 Li => "li",
90 Lst => "lst",
91 Tbl => "tbl",
92 Row => "row",
93 Cell => "cell",
94 Hdr => "hdr",
95 Nav => "nav",
96 Frm => "frm",
97 Dlg => "dlg",
98 Itm => "itm",
99 Sec => "sec",
100 Art => "art",
101 Mn => "mn",
102 Ifr => "ifr",
109 El => "el",
110 }
111}
112
113code_enum! {
114 pub enum Op as "op" {
116 Click => "click",
117 Fill => "fill",
118 Scroll => "scroll",
119 Key => "key",
120 Submit => "submit",
121 Hover => "hover",
122 Focus => "focus",
123 }
124}
125
126code_enum! {
127 pub enum ErrorCode as "error" {
129 StaleToken => "STALE_TOKEN",
130 EngineUnsupported => "ENGINE_UNSUPPORTED",
131 PolicyDeny => "POLICY_DENY",
132 Timeout => "TIMEOUT",
133 NotFound => "NOT_FOUND",
134 WrongSession => "WRONG_SESSION",
135 ConfirmRequired => "CONFIRM_REQUIRED",
136 DaemonStartFailed => "DAEMON_START_FAILED",
137 EngineCrash => "ENGINE_CRASH",
138 BadRequest => "BAD_REQUEST",
139 UnknownKind => "UNKNOWN_KIND",
140 EvalError => "EVAL_ERROR",
141 EvalSyntax => "EVAL_SYNTAX",
142 }
143}
144
145code_enum! {
146 pub enum WarningCode as "warning" {
148 Nav => "nav",
149 CaptchaVisible => "captcha_visible",
150 AuthLoaded => "auth_loaded",
151 ViewportChanged => "viewport_changed",
152 IdempotentHit => "idempotent_hit",
153 ConsoleError => "console_error",
154 HiddenTarget => "hidden_target",
155 MarkReaimed => "mark_reaimed",
156 StoragePartial => "storage_partial",
157 }
158}
159
160#[cfg(test)]
161mod tests {
162 use super::*;
163
164 fn round_trip<C>(samples: &[C])
165 where
166 C: Copy + PartialEq + fmt::Debug + fmt::Display + FromStr<Err = UnknownCode>,
167 {
168 for c in samples {
169 let s = c.to_string();
170 let parsed: C = s.parse().expect("known code");
171 assert_eq!(parsed, *c);
172 }
173 }
174
175 #[test]
176 fn roles_round_trip() {
177 round_trip(Role::all());
178 }
179
180 #[test]
181 fn ops_round_trip() {
182 round_trip(Op::all());
183 }
184
185 #[test]
186 fn error_codes_round_trip() {
187 round_trip(ErrorCode::all());
188 }
189
190 #[test]
191 fn warning_codes_round_trip() {
192 round_trip(WarningCode::all());
193 }
194
195 #[test]
196 fn unknown_role_rejected() {
197 let err = "xx".parse::<Role>().unwrap_err();
198 assert_eq!(err.kind, "role");
199 assert_eq!(err.value, "xx");
200 }
201
202 #[test]
203 fn unknown_error_rejected() {
204 let err = "WHATEVER".parse::<ErrorCode>().unwrap_err();
205 assert_eq!(err.kind, "error");
206 }
207
208 #[test]
209 fn role_display_matches_wire() {
210 assert_eq!(Role::Btn.to_string(), "btn");
211 assert_eq!(Role::Lnk.as_str(), "lnk");
212 }
213
214 #[test]
218 fn role_count() {
219 assert_eq!(Role::all().len(), 26);
220 assert_eq!(Op::all().len(), 7);
221 }
222
223 #[test]
224 fn iframe_role_round_trips() {
225 assert_eq!(Role::Ifr.as_str(), "ifr");
226 assert_eq!("ifr".parse::<Role>().unwrap(), Role::Ifr);
227 }
228}