scim_v2 0.4.2

A crate that provides utilities for working with the System for Cross-domain Identity Management (SCIM) version 2.0 protocol. (rfc7642, rfc7643, rfc7644)
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
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

use serde::Deserializer;

/// Deserializes to a boolean from either a boolean, string representation of boolean, or null.
///
/// Note: Must be paired with `#[serde(default)]` in order to handle missing fields.
pub(crate) fn deserialize_optional_lenient_bool<'de, D>(
    deserializer: D,
) -> Result<Option<bool>, D::Error>
where
    D: Deserializer<'de>,
{
    use serde::de;

    struct OptionalLenientBoolVisitor;

    impl<'de> de::Visitor<'de> for OptionalLenientBoolVisitor {
        type Value = Option<bool>;

        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
            formatter.write_str("a boolean, a string representing a boolean, or null")
        }

        fn visit_bool<E: de::Error>(self, v: bool) -> Result<Option<bool>, E> {
            Ok(Some(v))
        }

        fn visit_str<E: de::Error>(self, v: &str) -> Result<Option<bool>, E> {
            if v.eq_ignore_ascii_case("true") {
                Ok(Some(true))
            } else if v.eq_ignore_ascii_case("false") {
                Ok(Some(false))
            } else {
                Err(E::invalid_value(de::Unexpected::Str(v), &self))
            }
        }

        fn visit_none<E: de::Error>(self) -> Result<Option<bool>, E> {
            Ok(None)
        }

        fn visit_unit<E: de::Error>(self) -> Result<Option<bool>, E> {
            Ok(None)
        }
    }

    deserializer.deserialize_any(OptionalLenientBoolVisitor)
}

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

    #[derive(Deserialize)]
    struct WithDefault {
        #[serde(default, deserialize_with = "deserialize_optional_lenient_bool")]
        primary: Option<bool>,
    }

    #[derive(Deserialize)]
    struct WithoutDefault {
        #[serde(deserialize_with = "deserialize_optional_lenient_bool")]
        #[allow(dead_code)]
        primary: Option<bool>,
    }

    #[test]
    fn accepts_a_real_bool() {
        let parsed: WithDefault = serde_json::from_str(r#"{"primary": true}"#).unwrap();
        assert_eq!(parsed.primary, Some(true));

        let parsed: WithDefault = serde_json::from_str(r#"{"primary": false}"#).unwrap();
        assert_eq!(parsed.primary, Some(false));
    }

    #[test]
    fn accepts_a_stringified_bool_case_insensitively() {
        let parsed: WithDefault = serde_json::from_str(r#"{"primary": "True"}"#).unwrap();
        assert_eq!(parsed.primary, Some(true));

        let parsed: WithDefault = serde_json::from_str(r#"{"primary": "false"}"#).unwrap();
        assert_eq!(parsed.primary, Some(false));
    }

    #[test]
    fn rejects_a_non_boolean_string() {
        let result: Result<WithDefault, _> = serde_json::from_str(r#"{"primary": "maybe"}"#);
        assert!(result.is_err());
    }

    #[test]
    fn explicit_null_deserializes_to_none() {
        let parsed: WithDefault = serde_json::from_str(r#"{"primary": null}"#).unwrap();
        assert_eq!(parsed.primary, None);
    }

    #[test]
    fn omitted_key_deserializes_to_none_when_paired_with_serde_default() {
        let parsed: WithDefault = serde_json::from_str(r#"{}"#).unwrap();
        assert_eq!(parsed.primary, None);
    }

    #[test]
    fn omitted_key_fails_without_serde_default() {
        let result: Result<WithoutDefault, _> = serde_json::from_str(r#"{}"#);
        assert!(
            result.is_err(),
            "deserialize_with alone does not default an omitted key to None; \
             #[serde(default)] is required at the call site"
        );
    }
}