// 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 xso::{text::EmptyAsError, AsXml, FromXml}; use crate::ns; /// Represents an URI used in a media element. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::MEDIA_ELEMENT, name = "uri")] pub struct Uri { /// The MIME type of the URI referenced. /// /// See the [IANA MIME Media Types Registry][1] for a list of /// registered types, but unregistered or yet-to-be-registered are /// accepted too. /// /// [1]: #[xml(attribute(name = "type"))] pub type_: String, /// The actual URI contained. #[xml(text(codec = EmptyAsError))] pub uri: String, } /// References a media element, to be used in [data /// forms](../data_forms/index.html). #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::MEDIA_ELEMENT, name = "media")] pub struct MediaElement { /// The recommended display width in pixels. #[xml(attribute(default))] pub width: Option, /// The recommended display height in pixels. #[xml(attribute(default))] pub height: Option, /// A list of URIs referencing this media. #[xml(child(n = ..))] pub uris: Vec, } #[cfg(test)] mod tests { use super::*; use crate::data_forms::DataForm; use minidom::Element; use xso::error::{Error, FromElementError}; #[cfg(target_pointer_width = "32")] #[test] fn test_size() { assert_size!(Uri, 24); assert_size!(MediaElement, 28); } #[cfg(target_pointer_width = "64")] #[test] fn test_size() { assert_size!(Uri, 48); assert_size!(MediaElement, 56); } #[test] fn test_simple() { let elem: Element = "".parse().unwrap(); let media = MediaElement::try_from(elem).unwrap(); assert!(media.width.is_none()); assert!(media.height.is_none()); assert!(media.uris.is_empty()); } #[test] fn test_width_height() { let elem: Element = "" .parse() .unwrap(); let media = MediaElement::try_from(elem).unwrap(); assert_eq!(media.width.unwrap(), 32); assert_eq!(media.height.unwrap(), 32); } #[test] fn test_uri() { let elem: Element = "https://example.org/".parse().unwrap(); let media = MediaElement::try_from(elem).unwrap(); assert_eq!(media.uris.len(), 1); assert_eq!(media.uris[0].type_, "text/html"); assert_eq!(media.uris[0].uri, "https://example.org/"); } #[test] fn test_invalid_width_height() { let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let error = match error { FromElementError::Invalid(Error::TextParseError(error)) if error.is::() => { error } _ => panic!(), }; assert_eq!(error.to_string(), "cannot parse integer from empty string"); let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let error = match error { FromElementError::Invalid(Error::TextParseError(error)) if error.is::() => { error } _ => panic!(), }; assert_eq!(error.to_string(), "invalid digit found in string"); let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let error = match error { FromElementError::Invalid(Error::TextParseError(error)) if error.is::() => { error } _ => panic!(), }; assert_eq!(error.to_string(), "cannot parse integer from empty string"); let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let error = match error { FromElementError::Invalid(Error::TextParseError(error)) if error.is::() => { error } _ => panic!(), }; assert_eq!(error.to_string(), "invalid digit found in string"); } #[test] fn test_unknown_child() { let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let message = match error { FromElementError::Invalid(Error::Other(string)) => string, _ => panic!(), }; assert_eq!(message, "Unknown child in MediaElement element."); } #[test] fn test_bad_uri() { let elem: Element = "https://example.org/" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let message = match error { FromElementError::Invalid(Error::Other(string)) => string, _ => panic!(), }; assert_eq!( message, "Required attribute field 'type_' on Uri element missing." ); let elem: Element = "" .parse() .unwrap(); let error = MediaElement::try_from(elem).unwrap_err(); let message = match error { FromElementError::Invalid(Error::Other(string)) => string, _ => panic!(), }; assert_eq!(message, "Empty text node."); } #[test] fn test_xep_ex1() { let elem: Element = r#" http://victim.example.com/challenges/speech.wav?F3A6292C cid:sha1+a15a505e360702b79c75a5f67773072ed392f52a@bob.xmpp.org http://victim.example.com/challenges/speech.mp3?F3A6292C "# .parse() .unwrap(); let media = MediaElement::try_from(elem).unwrap(); assert!(media.width.is_none()); assert!(media.height.is_none()); assert_eq!(media.uris.len(), 3); assert_eq!(media.uris[0].type_, "audio/x-wav"); assert_eq!( media.uris[0].uri, "http://victim.example.com/challenges/speech.wav?F3A6292C" ); assert_eq!(media.uris[1].type_, "audio/ogg; codecs=speex"); assert_eq!( media.uris[1].uri, "cid:sha1+a15a505e360702b79c75a5f67773072ed392f52a@bob.xmpp.org" ); assert_eq!(media.uris[2].type_, "audio/mpeg"); assert_eq!( media.uris[2].uri, "http://victim.example.com/challenges/speech.mp3?F3A6292C" ); } #[test] fn test_xep_ex2() { let elem: Element = r#" [ ... ] http://www.victim.com/challenges/ocr.jpeg?F3A6292C cid:sha1+f24030b8d91d233bac14777be5ab531ca3b9f102@bob.xmpp.org [ ... ] "# .parse() .unwrap(); let form = DataForm::try_from(elem).unwrap(); assert_eq!(form.fields.len(), 1); assert_eq!(form.fields[0].var.as_deref(), Some("ocr")); assert_eq!(form.fields[0].media[0].width, Some(290)); assert_eq!(form.fields[0].media[0].height, Some(80)); assert_eq!(form.fields[0].media[0].uris[0].type_, "image/jpeg"); assert_eq!( form.fields[0].media[0].uris[0].uri, "http://www.victim.com/challenges/ocr.jpeg?F3A6292C" ); assert_eq!(form.fields[0].media[0].uris[1].type_, "image/jpeg"); assert_eq!( form.fields[0].media[0].uris[1].uri, "cid:sha1+f24030b8d91d233bac14777be5ab531ca3b9f102@bob.xmpp.org" ); } }