// Copyright (c) 2017 Emmanuel Gil Peyrot // // This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at http://mozilla.org/MPL/2.0/. use try_from::TryFrom; use minidom::Element; use error::Error; use ns; /// Requests paging through a potentially big set of items (represented by an /// UID). #[derive(Debug, Clone)] pub struct SetQuery { /// Limit the number of items, or use the recipient’s defaults if None. pub max: Option, /// The UID after which to give results, or if None it is the element /// “before” the first item, effectively an index of negative one. pub after: Option, /// The UID before which to give results, or if None it starts with the /// last page of the full set. pub before: Option, /// Numerical index of the page (deprecated). pub index: Option, } impl TryFrom for SetQuery { type Err = Error; fn try_from(elem: Element) -> Result { check_self!(elem, "set", RSM, "RSM set"); let mut set = SetQuery { max: None, after: None, before: None, index: None, }; for child in elem.children() { if child.is("max", ns::RSM) { if set.max.is_some() { return Err(Error::ParseError("Set can’t have more than one max.")); } set.max = Some(child.text().parse()?); } else if child.is("after", ns::RSM) { if set.after.is_some() { return Err(Error::ParseError("Set can’t have more than one after.")); } set.after = Some(child.text()); } else if child.is("before", ns::RSM) { if set.before.is_some() { return Err(Error::ParseError("Set can’t have more than one before.")); } set.before = Some(child.text()); } else if child.is("index", ns::RSM) { if set.index.is_some() { return Err(Error::ParseError("Set can’t have more than one index.")); } set.index = Some(child.text().parse()?); } else { return Err(Error::ParseError("Unknown child in set element.")); } } Ok(set) } } impl From for Element { fn from(set: SetQuery) -> Element { Element::builder("set") .ns(ns::RSM) .append(set.max.map(|max| Element::builder("max").ns(ns::RSM).append(format!("{}", max)).build())) .append(set.after.map(|after| Element::builder("after").ns(ns::RSM).append(after).build())) .append(set.before.map(|before| Element::builder("before").ns(ns::RSM).append(before).build())) .append(set.index.map(|index| Element::builder("index").ns(ns::RSM).append(format!("{}", index)).build())) .build() } } /// Describes the paging result of a [query](struct.SetQuery.html). #[derive(Debug, Clone)] pub struct SetResult { /// The UID of the first item of the page. pub first: Option, /// The position of the [first item](#structfield.first) in the full set /// (which may be approximate). pub first_index: Option, /// The UID of the last item of the page. pub last: Option, /// How many items there are in the full set (which may be approximate). pub count: Option, } impl TryFrom for SetResult { type Err = Error; fn try_from(elem: Element) -> Result { check_self!(elem, "set", RSM, "RSM set"); let mut set = SetResult { first: None, first_index: None, last: None, count: None, }; for child in elem.children() { if child.is("first", ns::RSM) { if set.first.is_some() { return Err(Error::ParseError("Set can’t have more than one first.")); } set.first_index = get_attr!(child, "index", optional); set.first = Some(child.text()); } else if child.is("last", ns::RSM) { if set.last.is_some() { return Err(Error::ParseError("Set can’t have more than one last.")); } set.last = Some(child.text()); } else if child.is("count", ns::RSM) { if set.count.is_some() { return Err(Error::ParseError("Set can’t have more than one count.")); } set.count = Some(child.text().parse()?); } else { return Err(Error::ParseError("Unknown child in set element.")); } } Ok(set) } } impl From for Element { fn from(set: SetResult) -> Element { let first = set.first.clone() .map(|first| Element::builder("first") .ns(ns::RSM) .attr("index", set.first_index) .append(first) .build()); Element::builder("set") .ns(ns::RSM) .append(first) .append(set.last.map(|last| Element::builder("last").ns(ns::RSM).append(last).build())) .append(set.count.map(|count| Element::builder("count").ns(ns::RSM).append(format!("{}", count)).build())) .build() } } #[cfg(test)] mod tests { use super::*; use compare_elements::NamespaceAwareCompare; #[test] fn test_simple() { let elem: Element = "".parse().unwrap(); let set = SetQuery::try_from(elem).unwrap(); assert_eq!(set.max, None); assert_eq!(set.after, None); assert_eq!(set.before, None); assert_eq!(set.index, None); let elem: Element = "".parse().unwrap(); let set = SetResult::try_from(elem).unwrap(); match set.first { Some(_) => panic!(), None => (), } assert_eq!(set.last, None); assert_eq!(set.count, None); } #[test] fn test_unknown() { let elem: Element = "".parse().unwrap(); let error = SetQuery::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "This is not a RSM set element."); let elem: Element = "".parse().unwrap(); let error = SetResult::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "This is not a RSM set element."); } #[test] fn test_invalid_child() { let elem: Element = "".parse().unwrap(); let error = SetQuery::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Unknown child in set element."); let elem: Element = "".parse().unwrap(); let error = SetResult::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Unknown child in set element."); } #[test] fn test_serialise() { let elem: Element = "".parse().unwrap(); let rsm = SetQuery { max: None, after: None, before: None, index: None, }; let elem2 = rsm.into(); assert_eq!(elem, elem2); let elem: Element = "".parse().unwrap(); let rsm = SetResult { first: None, first_index: None, last: None, count: None, }; let elem2 = rsm.into(); assert_eq!(elem, elem2); } #[test] fn test_first_index() { let elem: Element = "coucou".parse().unwrap(); let elem1 = elem.clone(); let set = SetResult::try_from(elem).unwrap(); assert_eq!(set.first, Some(String::from("coucou"))); assert_eq!(set.first_index, Some(4)); let set2 = SetResult { first: Some(String::from("coucou")), first_index: Some(4), last: None, count: None, }; let elem2 = set2.into(); assert!(elem1.compare_to(&elem2)); } }