Merge branch 'feat/oob' into 'main'

Add OOB

See merge request xmpp-rs/xmpp-rs!309

parsers/src/lib.rs

@@ -87,6 +87,9 @@ pub mod rsm;
 /// XEP-0060: Publish-Subscribe
 pub mod pubsub;
 
+/// XEP-0066: OOB
+pub mod oob;
+
 /// XEP-0071: XHTML-IM
 pub mod xhtml;
 

parsers/src/ns.rs

@@ -63,6 +63,9 @@ pub const PUBSUB_OWNER: &str = "http://jabber.org/protocol/pubsub#owner";
 /// XEP-0060: Publish-Subscribe node configuration
 pub const PUBSUB_CONFIGURE: &str = "http://jabber.org/protocol/pubsub#node_config";
 
+/// XEP-0066: Out of Band Data
+pub const OOB: &str = "jabber:x:oob";
+
 /// XEP-0071: XHTML-IM
 pub const XHTML_IM: &str = "http://jabber.org/protocol/xhtml-im";
 /// XEP-0071: XHTML-IM

parsers/src/oob.rs

@@ -0,0 +1,67 @@
+// Copyright (c) 2024 Paul Fariello <xmpp-parsers@fariello.eu>
+//
+// 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::message::MessagePayload;
+
+generate_element!(
+    /// Defines associated out of band url.
+    Oob, "x", OOB,
+    children: [
+        /// The associated URL.
+        url: Required<String> = ("url", OOB) => String,
+        /// An optionnal description of the out of band data.
+        desc: Option<String> = ("desc", OOB) => String,
+    ]
+);
+
+impl MessagePayload for Oob {}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::util::error::Error;
+    use crate::Element;
+
+    #[cfg(target_pointer_width = "32")]
+    #[test]
+    fn test_size() {
+        assert_size!(Oob, 24);
+    }
+
+    #[cfg(target_pointer_width = "64")]
+    #[test]
+    fn test_size() {
+        assert_size!(Oob, 48);
+    }
+
+    #[test]
+    fn test_simple() {
+        let elem: Element = "<x xmlns='jabber:x:oob'><url>http://example.org</url></x>"
+            .parse()
+            .unwrap();
+        Oob::try_from(elem).unwrap();
+    }
+
+    #[test]
+    fn test_with_desc() {
+        let elem: Element =
+            "<x xmlns='jabber:x:oob'><url>http://example.org</url><desc>Example website</desc></x>"
+                .parse()
+                .unwrap();
+        Oob::try_from(elem).unwrap();
+    }
+
+    #[test]
+    fn test_invalid_child() {
+        let elem: Element = "<x xmlns='jabber:x:oob'></x>".parse().unwrap();
+        let error = Oob::try_from(elem).unwrap_err();
+        let message = match error {
+            Error::ParseError(string) => string,
+            _ => panic!(),
+        };
+        assert_eq!(message, "Missing child url in x element.");
+    }
+}