mwapi_responses/
misc.rs

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
/*
Copyright (C) 2022 Kunal Mehta <legoktm@debian.org>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
use serde::{de, Deserialize};

#[derive(Clone, Debug, Deserialize)]
pub struct PageAssessment {
    pub class: String,
    pub importance: String,
}

/// Not public, for internal use only.
///
/// Deserialize booleans, treating empty string as `true`.
///
/// During the switch to API formatversion=2, some API modules continued to
/// output empty strings for booleans, so this gracefully handles that case
/// as well as when they are fixed to return proper booleans.
#[doc(hidden)]
pub fn deserialize_bool_or_string<'de, D>(
    deserializer: D,
) -> Result<bool, D::Error>
where
    D: de::Deserializer<'de>,
{
    let val = BooleanCompat::deserialize(deserializer)?;
    match val {
        BooleanCompat::V2(bool) => Ok(bool),
        // Empty string is true, anything else is an error.
        BooleanCompat::V1(val) => match val.as_str() {
            "" => Ok(true),
            _ => Err(de::Error::custom(format!("Unexpected value: {}", val))),
        },
    }
}

/// Enum to represent booleans in both `formatversion=1` (present empty string
/// for true) and `formatversion=2` (real booleans).
#[derive(Clone, Debug, Deserialize)]
#[serde(untagged)]
enum BooleanCompat {
    V2(bool),
    V1(String),
}