odata_client_util 0.1.0

Utilities for `odata_client` & related crates
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

//! Auxiliary deserialization functionality for usage with generated entity model code.

use iso8601::Duration;
use serde::{Deserialize, Deserializer};
use serde_with::DeserializeAs;

pub struct Iso8601DurationDeserialize;

impl<'de> DeserializeAs<'de, Duration> for Iso8601DurationDeserialize {
    fn deserialize_as<D: Deserializer<'de>>(deserializer: D) -> Result<Duration, D::Error> {
        let s = String::deserialize(deserializer)?;
        iso8601::duration(&s).map_err(|msg| serde::de::Error::custom(msg))
    }
}

pub use flattened_xml_attr_impl::flattened_xml_attr;

/// Workaround for a bug with deserialising flattened structs with serde-xml-rs:
/// <https://github.com/RReverser/serde-xml-rs/issues/137>
/// To apply this workaround, add this attribute to any primitive field which is either in a
/// flattened struct, or is being deserialised in a flattened struct via a transparent newtype:
/// `#[deserialize_with = "flattened_xml_attr"]`
mod flattened_xml_attr_impl {
    use fmt::Display;
    use serde::{Deserialize, Deserializer};
    use std::fmt;

    // Inspired by https://docs.rs/serde-aux/0.6.1/serde_aux/field_attributes/fn.deserialize_number_from_string.html
    pub fn flattened_xml_attr<'de, D: Deserializer<'de>, T: FromXmlStr + Deserialize<'de>>(
        deserializer: D,
    ) -> Result<T, D::Error> {
        #[derive(Deserialize)]
        #[serde(untagged)]
        enum TypeOrString<T> {
            Ty(T),
            String(String),
        }

        match TypeOrString::<T>::deserialize(deserializer)? {
            TypeOrString::Ty(t) => Ok(t),
            TypeOrString::String(s) => T::from_str(&s).map_err(serde::de::Error::custom),
        }
    }

    /// Trait to define on types which we need to deserialize from XML within a flattened struct,
    /// for which the `std::str::FromStr` is absent/unsuitable. This should mirror the behaviour
    /// of serde-xml-rs for Serde data model types.
    pub trait FromXmlStr: Sized {
        type Error: Display;
        fn from_str(s: &str) -> Result<Self, Self::Error>;
        fn deserialize_from_type<'de, D: Deserializer<'de>>(
            deserializer: D,
        ) -> Result<Self, D::Error>;
    }

    macro_rules! impl_from_xml_str_as_from_str {
        ($($t:ty)*) => {
            $(
                impl FromXmlStr for $t {
                    type Error = <$t as std::str::FromStr>::Err;
                    fn from_str(s: &str) -> Result<Self, Self::Error> {
                        s.parse()
                    }

                    fn deserialize_from_type<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
                        <$t>::deserialize(deserializer)
                    }
                }
            )*
        };
    }

    impl_from_xml_str_as_from_str! {
        usize u8 u16 u32 u64 u128
        isize i8 i16 i32 i64 i128
        f32 f64 char
    }

    /// Can parse from "1"/"0" as well as "true"/"false".
    impl FromXmlStr for bool {
        type Error = String;

        fn from_str(s: &str) -> Result<Self, Self::Error> {
            match s {
                "true" | "1" => Ok(true),
                "false" | "0" => Ok(false),
                s => Err(format!("\"{}\" is not a valid bool", s)),
            }
        }

        fn deserialize_from_type<'de, D: Deserializer<'de>>(
            deserializer: D,
        ) -> Result<Self, D::Error> {
            bool::deserialize(deserializer)
        }
    }
}