xml-data 0.0.1

Generic XML parsing and serializing
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

use crate::{
	parser::{
		ElementState,
		ElementParser,
	},
	Result,
	errors,
};
use std::borrow::Cow;

/// Convenience trait to implement instead of `ElementState` if your element has a fixed tag.
pub trait FixedElementState: Default {
	/// Same as `ElementState::Output`
	type Output: Sized;

	/// Fixed tag
	const TAG: &'static str;

	/// Same as `ElementState::parse_element_attribute`
	fn parse_element_attribute(&mut self, key: &str, value: Cow<'_, str>) -> Result<()> {
		let _ = value;
		return Err(errors::unexpected_attribute(key));
	}

	/// Same as `ElementState::parse_element_inner_text`
	fn parse_element_inner_text(&mut self, text: Cow<'_, str>) -> Result<()> {
		if !text.trim().is_empty() {
			return Err(errors::unexpected_text());
		}
		Ok(())
	}

	/// Same as `ElementState::parse_element_inner_node`
	fn parse_element_inner_node<P: ElementParser>(&mut self, tag: &str, parser: P) -> Result<()> {
		let _ = parser;
		return Err(errors::unexpected_element(tag));
	}

	/// Same as `ElementState::parse_element_finish`
	fn parse_element_finish(self) -> Result<Self::Output>;
}

impl<E: FixedElementState> ElementState for E {
	type Output = <E as FixedElementState>::Output;

	fn parse_element_start(tag: &str) -> Option<Self> {
		if tag == Self::TAG {
			Some(E::default())
		} else {
			None
		}
	}

	fn parse_element_attribute(&mut self, key: &str, value: Cow<'_, str>) -> Result<()> {
		<E as FixedElementState>::parse_element_attribute(self, key, value)
	}

	fn parse_element_inner_text(&mut self, text: Cow<'_, str>) -> Result<()> {
		<E as FixedElementState>::parse_element_inner_text(self, text)
	}

	fn parse_element_inner_node<P: ElementParser>(&mut self, tag: &str, parser: P) -> Result<()> {
		<E as FixedElementState>::parse_element_inner_node(self, tag, parser)
	}

	fn parse_element_finish(self) -> Result<Self::Output> {
		<E as FixedElementState>::parse_element_finish(self)
	}

	fn parse_error_not_found<T>() -> Result<T> {
		Err(errors::missing_element(Self::TAG))
	}
}