xmpp-rs/parsers/src/jingle_rtp_hdrext.rs
Emmanuel Gil Peyrot 7b66de1166 xmpp-parsers: Stop reexporting extra symbols
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.
2024-07-25 14:36:09 +00:00

86 lines
2.4 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 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/.
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
);
generate_element!(
/// Header extensions to be used in a RTP description.
RtpHdrext, "rtp-hdrext", JINGLE_RTP_HDREXT,
attributes: [
/// 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.
id: Required<u16> = "id",
/// The URI that defines the extension.
uri: Required<String> = "uri",
/// Which party is allowed to send the negotiated RTP Header Extensions.
senders: Default<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);
}
}