ssdp 0.1.1

An asynchronous abstraction for discovering devices and services on a network.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

use std::fmt::{Formatter, Result};

use hyper::header::{HeaderFormat, Header};

const SEARCHPORT_HEADER_NAME: &'static str = "SEARCHPORT.UPNP.ORG";

pub const SEARCHPORT_MIN_VALUE: u16 = 49152;
pub const SEARCHPORT_MAX_VALUE: u16 = 65535;

/// Represents a header used to specify a unicast port to send search requests to.
///
/// If a SearchPort header is not included in a message then the device must
/// respond to unicast search requests on the standard port of 1900.
#[derive(Copy, Clone, PartialEq, Eq, Hash, Debug)]
pub struct SearchPort(pub u16);

unsafe impl Sync for SearchPort { }

unsafe impl Send for SearchPort { }

impl Header for SearchPort {
    fn header_name() -> &'static str {
        SEARCHPORT_HEADER_NAME
    }
    
    fn parse_header(raw: &[Vec<u8>]) -> Option<Self> {
        if raw.len() != 1 {
            return None
        }
        
        let cow_str = String::from_utf8_lossy(&raw[0][..]);
        
        let value = match u16::from_str_radix(&*cow_str, 10) {
            Ok(n) => n,
            Err(_) => return None
        };
        
        if value <= SEARCHPORT_MAX_VALUE && value >= SEARCHPORT_MIN_VALUE {
            Some(SearchPort(value))
        } else {
            None
        }
    }
}

impl HeaderFormat for SearchPort {
    fn fmt_header(&self, fmt: &mut Formatter) -> Result {
        try!(fmt.write_fmt(format_args!("{}", self.0)));
        
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use hyper::header::{Header};
    
    use super::{SearchPort};
    
    #[test]
    fn positive_searchport() {
        let searchport_header_value = &[b"50000"[..].to_vec()];
        
        SearchPort::parse_header(searchport_header_value).unwrap();
    }
    
    #[test]
    fn positive_lower_bound() {
        let searchport_header_value = &[b"49152"[..].to_vec()];
        
        SearchPort::parse_header(searchport_header_value).unwrap();
    }
    
    #[test]
    fn positive_upper_bound() {
        let searchport_header_value = &[b"65535"[..].to_vec()];
        
        SearchPort::parse_header(searchport_header_value).unwrap();
    }
    
    #[test]
    #[should_panic]
    fn negative_reserved() {
        let searchport_header_value = &[b"49151"[..].to_vec()];
        
        SearchPort::parse_header(searchport_header_value).unwrap();
    }
    
    #[test]
    #[should_panic]
    fn negative_nan() {
        let searchport_header_value = &[b"49151a"[..].to_vec()];
        
        SearchPort::parse_header(searchport_header_value).unwrap();
    }
}