dxr 0.8.0

Declarative XML-RPC
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

use quick_xml::de::DeError;
use quick_xml::se::{QuoteLevel, SeError, Serializer};

use serde::{Deserialize, Serialize};

/// Custom function for serializing values as XML.
///
/// This function uses a custom [`Serializer`] that expands empty XML elements
/// (for example, `<value><string></string></value>` for an empty string value)
/// instead of using self-closing XML tags, which are not accepted by all XML-RPC
/// implementations.
///
/// This should be a drop-in replacement for [`quick_xml::se::to_string`].
pub(crate) fn serialize_xml<T>(value: &T) -> Result<String, SeError>
where
    T: Serialize,
{
    let mut buf = String::new();

    // initialize custom serializer that expands empty elements
    let mut serializer = Serializer::new(&mut buf);
    serializer.expand_empty_elements(true);
    serializer.set_quote_level(QuoteLevel::Full);

    value.serialize(serializer)?;
    Ok(buf)
}

/// Function for deserializing values from XML.
///
/// This is a wrapper around [`quick_xml::de::from_str`].
pub(crate) fn deserialize_xml<'de, T>(string: &'de str) -> Result<T, DeError>
where
    T: Deserialize<'de>,
{
    quick_xml::de::from_str(string)
}