stun_rs/attributes/turn/
xor_peer_address.rs

1const XOR_PEER_ADDRESS: u16 = 0x0012;
2
3crate::common::xor_socket_addr_attribute!(
4    /// The `XorPeerAddress` attribute specifies the address and port of the
5    ///  peer as seen from the TURN server.  (For example, the peer's server-
6    ///  reflexive transport address if the peer is behind a NAT.)
7    ///
8    /// # Examples
9    ///```rust
10    /// # use std::net::{IpAddr, Ipv4Addr, SocketAddr};
11    /// # use stun_rs::attributes::turn::XorPeerAddress;
12    /// let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
13    /// let attr = XorPeerAddress::from(socket);
14    ///
15    /// let socket = attr.socket_address();
16    /// assert_eq!(socket.port(), 8080);
17    /// assert_eq!(socket.is_ipv4(), true);
18    ///```
19    XorPeerAddress,
20    XOR_PEER_ADDRESS,
21);
22
23#[cfg(test)]
24mod tests {
25    use super::*;
26    use crate::StunAttribute;
27    use std::net::{IpAddr, Ipv4Addr, SocketAddr};
28
29    #[test]
30    fn xor_peer_address_stunt_attribute() {
31        let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
32        let attr = StunAttribute::XorPeerAddress(XorPeerAddress::from(socket));
33        assert!(attr.is_xor_peer_address());
34        assert!(attr.as_xor_peer_address().is_ok());
35        assert!(attr.as_unknown().is_err());
36
37        assert!(attr.attribute_type().is_comprehension_required());
38        assert!(!attr.attribute_type().is_comprehension_optional());
39
40        let dbg_fmt = format!("{:?}", attr);
41        assert_eq!("XorPeerAddress(XorPeerAddress(127.0.0.1:8080))", dbg_fmt);
42    }
43}