xmpp-rs/parsers/src/jingle_rtp_hdrext.rs

// Copyright (c) 2020 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 crate::ns;

generate_attribute!(
    /// Which party is allowed to send the negotiated RTP Header Extensions.
    Senders, "senders", {
        /// Both parties can send them.
        Both => "both",

        /// Only the initiator can send them.
        Initiator => "initiator",

        /// Only the responder can send them.
        Responder => "responder",
    }, Default = Both
);

/// Header extensions to be used in a RTP description.
#[derive(FromXml, AsXml, PartialEq, Debug, Clone)]
#[xml(namespace = ns::JINGLE_RTP_HDREXT, name = "rtp-hdrext")]
pub struct RtpHdrext {
    /// The ID of the extensions.  The allowed values are only in the 1-256, 4096-4351 ranges,
    /// this isn’t enforced by xmpp-parsers yet!
    // TODO: make it so.
    #[xml(attribute)]
    pub id: u16,

    /// The URI that defines the extension.
    #[xml(attribute)]
    pub uri: String,

    /// Which party is allowed to send the negotiated RTP Header Extensions.
    #[xml(attribute(default))]
    pub senders: Senders,
}

impl RtpHdrext {
    /// Create a new RTP header extension element.
    pub fn new(id: u16, uri: String) -> RtpHdrext {
        RtpHdrext {
            id,
            uri,
            senders: Default::default(),
        }
    }

    /// Set the senders.
    pub fn with_senders(mut self, senders: Senders) -> RtpHdrext {
        self.senders = senders;
        self
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use minidom::Element;

    #[cfg(target_pointer_width = "32")]
    #[test]
    fn test_size() {
        assert_size!(Senders, 1);
        assert_size!(RtpHdrext, 16);
    }

    #[cfg(target_pointer_width = "64")]
    #[test]
    fn test_size() {
        assert_size!(Senders, 1);
        assert_size!(RtpHdrext, 32);
    }

    #[test]
    fn parse_exthdr() {
        let elem: Element = "<rtp-hdrext xmlns='urn:xmpp:jingle:apps:rtp:rtp-hdrext:0'
                    uri='urn:ietf:params:rtp-hdrext:toffset'
                    id='1'/>"
            .parse()
            .unwrap();
        let rtp_hdrext = RtpHdrext::try_from(elem).unwrap();
        assert_eq!(rtp_hdrext.id, 1);
        assert_eq!(rtp_hdrext.uri, "urn:ietf:params:rtp-hdrext:toffset");
        assert_eq!(rtp_hdrext.senders, Senders::Both);
    }
}