1use serde::{Deserialize, Serialize};
2
3macro_rules! str_enum {
4 ($(#[$doc:meta])* $name:ident { $($(#[$vdoc:meta])* $variant:ident = $value:literal),+ $(,)? }) => {
5 $(#[$doc])*
6 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
7 pub enum $name {
8 $( $(#[$vdoc])* #[serde(rename = $value)] $variant ),+
9 }
10 impl $name {
11 pub const ALL: &'static [$name] = &[$($name::$variant),+];
13 pub fn as_str(self) -> &'static str {
15 match self { $($name::$variant => $value),+ }
16 }
17 }
18 impl std::str::FromStr for $name {
19 type Err = String;
20 fn from_str(s: &str) -> Result<Self, Self::Err> {
21 match s { $($value => Ok($name::$variant),)+ other => Err(format!("unknown {}: {other}", stringify!($name))) }
22 }
23 }
24 impl std::fmt::Display for $name {
25 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { f.write_str(self.as_str()) }
26 }
27 };
28}
29
30str_enum! {
31 Autosend {
33 Off = "off",
35 WifiOnly = "wifi_only",
37 CellularOnly = "cellular_only",
39 WifiAndCellular = "wifi_and_cellular",
41 }
42}
43
44str_enum! {
45 FormUpdateMode {
47 Manual = "manual",
49 PreviouslyDownloaded = "previously_downloaded",
51 MatchExactly = "match_exactly",
53 }
54}
55
56str_enum! {
57 PeriodicCheck {
59 Every15Minutes = "every_fifteen_minutes",
61 EveryHour = "every_one_hour",
63 Every6Hours = "every_six_hours",
65 Every24Hours = "every_24_hours",
67 }
68}
69
70str_enum! {
71 Navigation {
73 Swipe = "swipe",
75 Buttons = "buttons",
77 SwipeAndButtons = "swipe_buttons",
79 }
80}
81
82str_enum! {
83 ConstraintBehavior {
85 OnSwipe = "on_swipe",
87 OnFinalize = "on_finalize",
89 }
90}
91
92str_enum! {
93 GuidanceHint {
95 No = "no",
97 Yes = "yes",
99 YesCollapsed = "yes_collapsed",
101 }
102}
103
104str_enum! {
105 ImageSize {
107 Original = "original",
109 VerySmall = "very_small",
111 Small = "small",
113 Medium = "medium",
115 Large = "large",
117 }
118}
119
120str_enum! {
121 Theme {
123 Light = "light_theme",
125 Dark = "dark_theme",
127 }
128}
129
130str_enum! {
131 BasemapSource {
133 Google = "google",
135 Mapbox = "mapbox",
137 Osm = "osm",
139 Usgs = "usgs",
141 Carto = "carto",
143 }
144}
145
146#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
148#[serde(into = "u8", try_from = "u8")]
149pub enum FontSize {
150 ExtraSmall,
152 Small,
154 Medium,
156 Large,
158 ExtraLarge,
160}
161
162impl From<FontSize> for u8 {
163 fn from(f: FontSize) -> u8 {
164 match f {
165 FontSize::ExtraSmall => 13,
166 FontSize::Small => 17,
167 FontSize::Medium => 21,
168 FontSize::Large => 25,
169 FontSize::ExtraLarge => 29,
170 }
171 }
172}
173
174impl TryFrom<u8> for FontSize {
175 type Error = String;
176 fn try_from(v: u8) -> Result<Self, Self::Error> {
177 Ok(match v {
178 13 => FontSize::ExtraSmall,
179 17 => FontSize::Small,
180 21 => FontSize::Medium,
181 25 => FontSize::Large,
182 29 => FontSize::ExtraLarge,
183 other => {
184 return Err(format!(
185 "font_size must be 13, 17, 21, 25 or 29, got {other}"
186 ))
187 }
188 })
189 }
190}
191
192#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
195pub struct General {
196 #[serde(default, skip_serializing_if = "Option::is_none")]
199 pub protocol: Option<String>,
200 #[serde(default, skip_serializing_if = "Option::is_none")]
204 pub server_url: Option<String>,
205 #[serde(default, skip_serializing_if = "Option::is_none")]
207 pub username: Option<String>,
208 #[serde(default, skip_serializing_if = "Option::is_none")]
210 pub password: Option<String>,
211 #[serde(default, skip_serializing_if = "Option::is_none")]
214 pub formlist_url: Option<String>,
215 #[serde(default, skip_serializing_if = "Option::is_none")]
217 pub submission_url: Option<String>,
218
219 #[serde(default, rename = "appTheme", skip_serializing_if = "Option::is_none")]
222 pub app_theme: Option<Theme>,
223 #[serde(default, skip_serializing_if = "Option::is_none")]
225 pub app_language: Option<String>,
226 #[serde(default, skip_serializing_if = "Option::is_none")]
228 pub font_size: Option<FontSize>,
229 #[serde(default, skip_serializing_if = "Option::is_none")]
231 pub navigation: Option<Navigation>,
232
233 #[serde(default, skip_serializing_if = "Option::is_none")]
236 pub basemap_source: Option<BasemapSource>,
237 #[serde(default, skip_serializing_if = "Option::is_none")]
239 pub google_map_style: Option<u8>,
240 #[serde(default, skip_serializing_if = "Option::is_none")]
242 pub mapbox_map_style: Option<String>,
243 #[serde(default, skip_serializing_if = "Option::is_none")]
245 pub usgs_map_style: Option<String>,
246 #[serde(default, skip_serializing_if = "Option::is_none")]
248 pub carto_map_style: Option<String>,
249 #[serde(default, skip_serializing_if = "Option::is_none")]
251 pub reference_layer: Option<String>,
252
253 #[serde(default, skip_serializing_if = "Option::is_none")]
256 pub form_update_mode: Option<FormUpdateMode>,
257 #[serde(default, skip_serializing_if = "Option::is_none")]
259 pub periodic_form_updates_check: Option<PeriodicCheck>,
260 #[serde(default, skip_serializing_if = "Option::is_none")]
262 pub automatic_update: Option<bool>,
263 #[serde(default, skip_serializing_if = "Option::is_none")]
265 pub hide_old_form_versions: Option<bool>,
266 #[serde(default, skip_serializing_if = "Option::is_none")]
268 pub autosend: Option<Autosend>,
269 #[serde(
271 default,
272 rename = "delete_send",
273 skip_serializing_if = "Option::is_none"
274 )]
275 pub delete_send: Option<bool>,
276 #[serde(default, skip_serializing_if = "Option::is_none")]
278 pub default_completed: Option<bool>,
279 #[serde(default, skip_serializing_if = "Option::is_none")]
281 pub constraint_behavior: Option<ConstraintBehavior>,
282 #[serde(default, skip_serializing_if = "Option::is_none")]
284 pub high_resolution: Option<bool>,
285 #[serde(default, skip_serializing_if = "Option::is_none")]
287 pub image_size: Option<ImageSize>,
288 #[serde(default, skip_serializing_if = "Option::is_none")]
290 pub external_app_recording: Option<bool>,
291 #[serde(default, skip_serializing_if = "Option::is_none")]
293 pub guidance_hint: Option<GuidanceHint>,
294 #[serde(
296 default,
297 rename = "instance_sync",
298 skip_serializing_if = "Option::is_none"
299 )]
300 pub instance_sync: Option<bool>,
301
302 #[serde(default, skip_serializing_if = "Option::is_none")]
305 pub analytics: Option<bool>,
306 #[serde(default, skip_serializing_if = "Option::is_none")]
308 pub metadata_username: Option<String>,
309 #[serde(default, skip_serializing_if = "Option::is_none")]
311 pub metadata_phonenumber: Option<String>,
312 #[serde(default, skip_serializing_if = "Option::is_none")]
314 pub metadata_email: Option<String>,
315
316 #[serde(default, flatten, skip_serializing_if = "serde_json::Map::is_empty")]
319 pub extra: serde_json::Map<String, serde_json::Value>,
320}
321
322impl General {
323 pub fn auto_sync(
328 server_url: impl Into<String>,
329 username: impl Into<String>,
330 password: impl Into<String>,
331 ) -> Self {
332 General {
333 server_url: Some(server_url.into()),
334 username: Some(username.into()),
335 password: Some(password.into()),
336 form_update_mode: Some(FormUpdateMode::MatchExactly),
337 periodic_form_updates_check: Some(PeriodicCheck::Every15Minutes),
338 automatic_update: Some(true),
339 hide_old_form_versions: Some(true),
340 autosend: Some(Autosend::WifiAndCellular),
341 delete_send: Some(false),
342 ..Default::default()
343 }
344 }
345}
346
347#[cfg(test)]
348mod tests {
349 use super::*;
350
351 #[test]
352 fn enum_strings_match_collect() {
353 assert_eq!(
354 serde_json::to_string(&Autosend::WifiAndCellular).unwrap(),
355 "\"wifi_and_cellular\""
356 );
357 assert_eq!(serde_json::to_string(&FontSize::Medium).unwrap(), "21");
358 assert_eq!(
359 serde_json::from_str::<FontSize>("29").unwrap(),
360 FontSize::ExtraLarge
361 );
362 assert!(serde_json::from_str::<FontSize>("20").is_err());
363 assert_eq!(
364 "match_exactly".parse::<FormUpdateMode>().unwrap(),
365 FormUpdateMode::MatchExactly
366 );
367 }
368
369 #[test]
370 fn unknown_keys_survive() {
371 let g: General =
372 serde_json::from_str(r#"{"server_url":"https://x","future_key":1}"#).unwrap();
373 assert_eq!(g.extra["future_key"], 1);
374 let json = serde_json::to_string(&g).unwrap();
375 assert!(json.contains("future_key"));
376 }
377}