Crate xml_stinks

XML is awful.

Examples

use std::convert::Infallible;

use xml_stinks::deserializer::buffered::Buffered as BufferedDeserializer;
use xml_stinks::deserializer::{Deserializer, IgnoreEnd};
use xml_stinks::tagged::TagStart;
use xml_stinks::DeserializeTagged;

let mut deserializer =
    BufferedDeserializer::new("<foo>Baz<bar>DF</bar></foo>".as_bytes());

let foo = deserializer.de_tag::<Foo>("foo", IgnoreEnd::No).unwrap();

assert_eq!(&foo.name, "Baz");
assert_eq!(foo.bar.num, 223);

struct Foo
{
    name: String,
    bar: Bar,
}

impl DeserializeTagged for Foo
{
    type Error = Infallible;

    fn deserialize<TDeserializer: Deserializer>(
        start: &TagStart,
        deserializer: &mut TDeserializer,
    ) -> Result<Self, Self::Error>
    {
        let name = deserializer.de_text().unwrap();

        let bar = deserializer.de_tag::<Bar>("bar", IgnoreEnd::No).unwrap();

        Ok(Self { name, bar })
    }
}

struct Bar
{
    num: u32,
}

impl DeserializeTagged for Bar
{
    type Error = Infallible;

    fn deserialize<TDeserializer: Deserializer>(
        start: &TagStart,
        deserializer: &mut TDeserializer,
    ) -> Result<Self, Self::Error>
    {
        let num = u32::from_str_radix(&deserializer.de_text().unwrap(), 16).unwrap();

        Ok(Self { num })
    }
}

Modules

attribute

Attribute.

deserializer

Deserializer.

escape

XML character escape things.

tagged

Tagged element.

Macros

impl_from_deserializer_error

Implements conversion from Error with From for the given error type.

xml_stinks_if_deserializer_static_generics

Conditional compilation based on whether or not the deserializer-static-generics feature is enabled.

Traits

DeserializeTagged

Trait implemented by types that want to be deserializable from tagged XML elements.

ResultExt

Result extension.