// 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 crate::util::helpers::Base64; use crate::iq::IqSetPayload; generate_id!( /// An identifier matching a stream. StreamId ); generate_attribute!( /// Which stanza type to use to exchange data. Stanza, "stanza", { /// `` gives a feedback on whether the chunk has been received or not, /// which is useful in the case the recipient might not receive them in a /// timely manner, or to do your own throttling based on the results. Iq => "iq", /// `` can be faster, since it doesn’t require any feedback, but in /// practice it will be throttled by the servers on the way. Message => "message", }, Default = Iq); generate_element!( /// Starts an In-Band Bytestream session with the given parameters. Open, "open", IBB, attributes: [ /// Maximum size in bytes for each chunk. block_size: Required = "block-size", /// The identifier to be used to create a stream. sid: Required = "sid", /// Which stanza type to use to exchange data. stanza: Default = "stanza", ]); impl IqSetPayload for Open {} generate_element!( /// Exchange a chunk of data in an open stream. Data, "data", IBB, attributes: [ /// Sequence number of this chunk, must wraparound after 65535. seq: Required = "seq", /// The identifier of the stream on which data is being exchanged. sid: Required = "sid" ], text: ( /// Vector of bytes to be exchanged. data: Base64> ) ); impl IqSetPayload for Data {} generate_element!( /// Close an open stream. Close, "close", IBB, attributes: [ /// The identifier of the stream to be closed. sid: Required = "sid", ]); impl IqSetPayload for Close {} #[cfg(test)] mod tests { use super::*; use crate::util::error::Error; use crate::Element; use std::error::Error as StdError; use std::convert::TryFrom; #[cfg(target_pointer_width = "32")] #[test] fn test_size() { assert_size!(StreamId, 12); assert_size!(Stanza, 1); assert_size!(Open, 16); assert_size!(Data, 28); assert_size!(Close, 12); } #[cfg(target_pointer_width = "64")] #[test] fn test_size() { assert_size!(StreamId, 24); assert_size!(Stanza, 1); assert_size!(Open, 32); assert_size!(Data, 56); assert_size!(Close, 24); } #[test] fn test_simple() { let sid = StreamId(String::from("coucou")); let elem: Element = "" .parse() .unwrap(); let open = Open::try_from(elem).unwrap(); assert_eq!(open.block_size, 3); assert_eq!(open.sid, sid); assert_eq!(open.stanza, Stanza::Iq); let elem: Element = "AAAA" .parse() .unwrap(); let data = Data::try_from(elem).unwrap(); assert_eq!(data.seq, 0); assert_eq!(data.sid, sid); assert_eq!(data.data, vec!(0, 0, 0)); let elem: Element = "" .parse() .unwrap(); let close = Close::try_from(elem).unwrap(); assert_eq!(close.sid, sid); } #[test] fn test_invalid() { let elem: Element = "" .parse() .unwrap(); let error = Open::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Required attribute 'block-size' missing."); let elem: Element = "" .parse() .unwrap(); let error = Open::try_from(elem).unwrap_err(); let message = match error { Error::ParseIntError(error) => error, _ => panic!(), }; assert_eq!(message.description(), "invalid digit found in string"); let elem: Element = "" .parse() .unwrap(); let error = Open::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(error) => error, _ => panic!(), }; assert_eq!(message, "Required attribute 'sid' missing."); } #[test] fn test_invalid_stanza() { let elem: Element = "".parse().unwrap(); let error = Open::try_from(elem).unwrap_err(); let message = match error { Error::ParseError(string) => string, _ => panic!(), }; assert_eq!(message, "Unknown value for 'stanza' attribute."); } }