// Copyright (c) 2017 Emmanuel Gil Peyrot // Copyright (c) 2017 Maxime “pep” Buquet // // 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 std::str::FromStr; use std::collections::BTreeMap; use minidom::{Element, IntoElements, IntoAttributeValue, ElementEmitter}; use jid::Jid; use error::Error; use ns; /// Should be implemented on every known payload of a ``. pub trait PresencePayload: TryFrom + Into {} /// Specifies the availability of an entity or resource. #[derive(Debug, Clone, PartialEq)] pub enum Show { /// Not an actual show value, but an indication there is no show set. None, /// The entity or resource is temporarily away. Away, /// The entity or resource is actively interested in chatting. Chat, /// The entity or resource is busy (dnd = "Do Not Disturb"). Dnd, /// The entity or resource is away for an extended period (xa = "eXtended /// Away"). Xa, } impl Default for Show { fn default() -> Show { Show::None } } impl FromStr for Show { type Err = Error; fn from_str(s: &str) -> Result { Ok(match s { "away" => Show::Away, "chat" => Show::Chat, "dnd" => Show::Dnd, "xa" => Show::Xa, _ => return Err(Error::ParseError("Invalid value for show.")), }) } } impl IntoElements for Show { fn into_elements(self, emitter: &mut ElementEmitter) { if self == Show::None { return; } emitter.append_child( Element::builder("show") .append(match self { Show::None => unreachable!(), Show::Away => Some("away"), Show::Chat => Some("chat"), Show::Dnd => Some("dnd"), Show::Xa => Some("xa"), }) .build()) } } type Lang = String; type Status = String; type Priority = i8; /// #[derive(Debug, Clone, PartialEq)] pub enum Type { /// This value is not an acceptable 'type' attribute, it is only used /// internally to signal the absence of 'type'. None, /// An error has occurred regarding processing of a previously sent /// presence stanza; if the presence stanza is of type "error", it MUST /// include an child element (refer to [XMPP‑CORE]). Error, /// A request for an entity's current presence; SHOULD be generated only by /// a server on behalf of a user. Probe, /// The sender wishes to subscribe to the recipient's presence. Subscribe, /// The sender has allowed the recipient to receive their presence. Subscribed, /// The sender is no longer available for communication. Unavailable, /// The sender is unsubscribing from the receiver's presence. Unsubscribe, /// The subscription request has been denied or a previously granted /// subscription has been canceled. Unsubscribed, } impl Default for Type { fn default() -> Type { Type::None } } impl FromStr for Type { type Err = Error; fn from_str(s: &str) -> Result { Ok(match s { "error" => Type::Error, "probe" => Type::Probe, "subscribe" => Type::Subscribe, "subscribed" => Type::Subscribed, "unavailable" => Type::Unavailable, "unsubscribe" => Type::Unsubscribe, "unsubscribed" => Type::Unsubscribed, _ => return Err(Error::ParseError("Invalid 'type' attribute on presence element.")), }) } } impl IntoAttributeValue for Type { fn into_attribute_value(self) -> Option { Some(match self { Type::None => return None, Type::Error => "error", Type::Probe => "probe", Type::Subscribe => "subscribe", Type::Subscribed => "subscribed", Type::Unavailable => "unavailable", Type::Unsubscribe => "unsubscribe", Type::Unsubscribed => "unsubscribed", }.to_owned()) } } /// The main structure representing the `` stanza. #[derive(Debug, Clone)] pub struct Presence { /// The sender of this presence. pub from: Option, /// The recipient of this presence. pub to: Option, /// The identifier, unique on this stream, of this stanza. pub id: Option, /// The type of this presence stanza. pub type_: Type, /// The availability of the sender of this presence. pub show: Show, /// A localised list of statuses defined in this presence. pub statuses: BTreeMap, /// The sender’s resource priority, if negative it won’t receive messages /// that haven’t been directed to it. pub priority: Priority, /// A list of payloads contained in this presence. pub payloads: Vec, } impl Presence { /// Create a new presence of this type. pub fn new(type_: Type) -> Presence { Presence { from: None, to: None, id: None, type_: type_, show: Show::None, statuses: BTreeMap::new(), priority: 0i8, payloads: vec!(), } } /// Set the emitter of this presence, this should only be useful for /// servers and components, as clients can only send presences from their /// own resource (which is implicit). pub fn with_from(mut self, from: Option) -> Presence { self.from = from; self } /// Set the recipient of this presence, this is only useful for directed /// presences. pub fn with_to(mut self, to: Option) -> Presence { self.to = to; self } /// Set the identifier for this presence. pub fn with_id(mut self, id: Option) -> Presence { self.id = id; self } /// Set the availability information of this presence. pub fn with_show(mut self, show: Show) -> Presence { self.show = show; self } /// Set the priority of this presence. pub fn with_priority(mut self, priority: i8) -> Presence { self.priority = priority; self } /// Set the payloads of this presence. pub fn with_payloads(mut self, payloads: Vec) -> Presence { self.payloads = payloads; self } /// Set the availability information of this presence. pub fn set_status(&mut self, lang: Lang, status: Status) { self.statuses.insert(lang, status); } /// Add a payload to this presence. pub fn add_payload(&mut self, payload: P) { self.payloads.push(payload.into()); } } impl TryFrom for Presence { type Err = Error; fn try_from(root: Element) -> Result { check_self!(root, "presence", DEFAULT_NS); let mut show = None; let mut priority = None; let mut presence = Presence { from: get_attr!(root, "from", optional), to: get_attr!(root, "to", optional), id: get_attr!(root, "id", optional), type_: get_attr!(root, "type", default), show: Show::None, statuses: BTreeMap::new(), priority: 0i8, payloads: vec!(), }; for elem in root.children() { if elem.is("show", ns::DEFAULT_NS) { if show.is_some() { return Err(Error::ParseError("More than one show element in a presence.")); } check_no_attributes!(elem, "show"); check_no_children!(elem, "show"); show = Some(Show::from_str(elem.text().as_ref())?); } else if elem.is("status", ns::DEFAULT_NS) { check_no_unknown_attributes!(elem, "status", ["xml:lang"]); check_no_children!(elem, "status"); let lang = get_attr!(elem, "xml:lang", default); if presence.statuses.insert(lang, elem.text()).is_some() { return Err(Error::ParseError("Status element present twice for the same xml:lang.")); } } else if elem.is("priority", ns::DEFAULT_NS) { if priority.is_some() { return Err(Error::ParseError("More than one priority element in a presence.")); } check_no_attributes!(elem, "priority"); check_no_children!(elem, "priority"); priority = Some(Priority::from_str(elem.text().as_ref())?); } else { presence.payloads.push(elem.clone()); } } if let Some(show) = show { presence.show = show; } if let Some(priority) = priority { presence.priority = priority; } Ok(presence) } } impl From for Element { fn from(presence: Presence) -> Element { Element::builder("presence") .ns(ns::DEFAULT_NS) .attr("from", presence.from) .attr("to", presence.to) .attr("id", presence.id) .attr("type", presence.type_) .append(presence.show) .append(presence.statuses.into_iter().map(|(lang, status)| { Element::builder("status") .attr("xml:lang", match lang.as_ref() { "" => None, lang => Some(lang), }) .append(status) .build() }).collect::>()) .append(if presence.priority == 0 { None } else { Some(format!("{}", presence.priority)) }) .append(presence.payloads) .build() } } #[cfg(test)] mod tests { use super::*; use compare_elements::NamespaceAwareCompare; #[cfg(target_pointer_width = "32")] #[test] fn test_size() { assert_size!(Show, 1); assert_size!(Type, 1); assert_size!(Presence, 112); } #[cfg(target_pointer_width = "64")] #[test] fn test_size() { assert_size!(Show, 1); assert_size!(Type, 1); assert_size!(Presence, 224); } #[test] fn test_simple() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.from, None); assert_eq!(presence.to, None); assert_eq!(presence.id, None); assert_eq!(presence.type_, Type::None); assert!(presence.payloads.is_empty()); } #[test] fn test_serialise() { #[cfg(not(feature = "component"))] let elem: Element = "/>".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "/>".parse().unwrap(); let presence = Presence::new(Type::Unavailable); let elem2 = presence.into(); assert!(elem.compare_to(&elem2)); } #[test] fn test_show() { #[cfg(not(feature = "component"))] let elem: Element = "chat".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "chat".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.payloads.len(), 0); assert_eq!(presence.show, Show::Chat); } #[test] fn test_missing_show_value() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Invalid value for show."); } #[test] fn test_invalid_show() { // "online" used to be a pretty common mistake. #[cfg(not(feature = "component"))] let elem: Element = "online".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "online".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Invalid value for show."); } #[test] fn test_empty_status() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.payloads.len(), 0); assert_eq!(presence.statuses.len(), 1); assert_eq!(presence.statuses[""], ""); } #[test] fn test_status() { #[cfg(not(feature = "component"))] let elem: Element = "Here!".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "Here!".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.payloads.len(), 0); assert_eq!(presence.statuses.len(), 1); assert_eq!(presence.statuses[""], "Here!"); } #[test] fn test_multiple_statuses() { #[cfg(not(feature = "component"))] let elem: Element = "Here!Là!".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "Here!Là!".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.payloads.len(), 0); assert_eq!(presence.statuses.len(), 2); assert_eq!(presence.statuses[""], "Here!"); assert_eq!(presence.statuses["fr"], "Là!"); } #[test] fn test_invalid_multiple_statuses() { #[cfg(not(feature = "component"))] let elem: Element = "Here!Là!".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "Here!Là!".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Status element present twice for the same xml:lang."); } #[test] fn test_priority() { #[cfg(not(feature = "component"))] let elem: Element = "-1".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "-1".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); assert_eq!(presence.payloads.len(), 0); assert_eq!(presence.priority, -1i8); } #[test] fn test_invalid_priority() { #[cfg(not(feature = "component"))] let elem: Element = "128".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "128".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); match error { Error::ParseIntError(_) => (), _ => panic!(), }; } #[test] fn test_unknown_child() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let presence = Presence::try_from(elem).unwrap(); let payload = &presence.payloads[0]; assert!(payload.is("test", "invalid")); } #[test] fn test_invalid_status_child() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Unknown child in status element."); } #[test] fn test_invalid_attribute() { #[cfg(not(feature = "component"))] let elem: Element = "".parse().unwrap(); #[cfg(feature = "component")] let elem: Element = "".parse().unwrap(); let error = Presence::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Unknown attribute in status element."); } #[test] fn test_serialise_status() { let status = Status::from("Hello world!"); let mut presence = Presence::new(Type::Unavailable); presence.statuses.insert(String::from(""), status); let elem: Element = presence.into(); assert!(elem.is("presence", ns::DEFAULT_NS)); assert!(elem.children().next().unwrap().is("status", ns::DEFAULT_NS)); } }