7b66de1166
Let’s continue reexporting jid and minidom, but not their inner pub items, users of this crate can go one level deeper if they need that. Only xso::error::Error is still useful to reexport, as this is part of the public API of all of our parsers.
111 lines
3.3 KiB
Rust
111 lines
3.3 KiB
Rust
// Copyright (c) 2018 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
|
|
//
|
|
// 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 xso::{AsXml, FromXml};
|
|
|
|
use jid::BareJid;
|
|
|
|
use crate::ns;
|
|
|
|
/// The stream opening for client-server communications.
|
|
#[derive(FromXml, AsXml, PartialEq, Debug, Clone)]
|
|
#[xml(namespace = ns::STREAM, name = "stream")]
|
|
pub struct Stream {
|
|
/// The JID of the entity opening this stream.
|
|
#[xml(attribute(default))]
|
|
pub from: Option<BareJid>,
|
|
|
|
/// The JID of the entity receiving this stream opening.
|
|
#[xml(attribute(default))]
|
|
to: Option<BareJid>,
|
|
|
|
/// The id of the stream, used for authentication challenges.
|
|
#[xml(attribute(default))]
|
|
id: Option<String>,
|
|
|
|
/// The XMPP version used during this stream.
|
|
#[xml(attribute(default))]
|
|
version: Option<String>,
|
|
|
|
/// The default human language for all subsequent stanzas, which will
|
|
/// be transmitted to other entities for better localisation.
|
|
#[xml(attribute(default, name = "xml:lang"))]
|
|
xml_lang: Option<String>,
|
|
}
|
|
|
|
impl Stream {
|
|
/// Creates a simple client→server `<stream:stream>` element.
|
|
pub fn new(to: BareJid) -> 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 `<stream:stream>`
|
|
/// element.
|
|
pub fn with_from(mut self, from: BareJid) -> Stream {
|
|
self.from = Some(from);
|
|
self
|
|
}
|
|
|
|
/// Sets the [@id](#structfield.id) attribute on this `<stream:stream>`
|
|
/// 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
|
|
/// `<stream:stream>` 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 minidom::Element;
|
|
|
|
#[cfg(target_pointer_width = "32")]
|
|
#[test]
|
|
fn test_size() {
|
|
assert_size!(Stream, 68);
|
|
}
|
|
|
|
#[cfg(target_pointer_width = "64")]
|
|
#[test]
|
|
fn test_size() {
|
|
assert_size!(Stream, 136);
|
|
}
|
|
|
|
#[test]
|
|
fn test_simple() {
|
|
let elem: Element = "<stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' xml:lang='en' version='1.0' id='abc' from='some-server.example'/>".parse().unwrap();
|
|
let stream = Stream::try_from(elem).unwrap();
|
|
assert_eq!(
|
|
stream.from,
|
|
Some(BareJid::new("some-server.example").unwrap())
|
|
);
|
|
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")));
|
|
}
|
|
}
|