// Copyright (c) 2018 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 jid::Jid; generate_element!( /// The stream opening for client-server communications. Stream, "stream", STREAM, attributes: [ /// The JID of the entity opening this stream. from: Option = "from" => optional, /// The JID of the entity receiving this stream opening. to: Option = "to" => optional, /// The id of the stream, used for authentication challenges. id: Option = "id" => optional, /// The XMPP version used during this stream. version: Option = "version" => optional, /// The default human language for all subsequent stanzas, which will /// be transmitted to other entities for better localisation. xml_lang: Option = "xml:lang" => optional, ] ); impl Stream { /// Creates a simple client→server `` element. pub fn new(to: Jid) -> Stream { Stream { from: None, to: Some(to), id: None, version: Some(String::from("1.0")), xml_lang: None, } } /// Sets the [@from](#structfield.from) attribute on this `` /// element. pub fn with_from(mut self, from: Jid) -> Stream { self.from = Some(from); self } /// Sets the [@id](#structfield.id) attribute on this `` /// element. pub fn with_id(mut self, id: String) -> Stream { self.id = Some(id); self } /// Sets the [@xml:lang](#structfield.xml_lang) attribute on this /// `` element. pub fn with_lang(mut self, xml_lang: String) -> Stream { self.xml_lang = Some(xml_lang); self } /// Checks whether the version matches the expected one. pub fn is_version(&self, version: &str) -> bool { match self.version { None => false, Some(ref self_version) => self_version == &String::from(version), } } } #[cfg(test)] mod tests { use super::*; use try_from::TryFrom; use minidom::Element; #[test] fn test_simple() { let elem: Element = "".parse().unwrap(); let stream = Stream::try_from(elem).unwrap(); assert_eq!(stream.from, Some(Jid::domain("some-server.example"))); assert_eq!(stream.to, None); assert_eq!(stream.id, Some(String::from("abc"))); assert_eq!(stream.version, Some(String::from("1.0"))); assert_eq!(stream.xml_lang, Some(String::from("en"))); } }