ssdp 0.7.0

An asynchronous abstraction for discovering devices and services on a network.
Documentation 
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

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

use hyper::error::{self, Error};
use hyper::header::{HeaderFormat, Header};

const CONFIGID_HEADER_NAME: &'static str = "CONFIGID.UPNP.ORG";

/// Represents a header used to denote the configuration of a device's DDD.
#[derive(Copy, Clone, PartialEq, Eq, Hash, Debug)]
pub struct ConfigID(pub u32);

impl Header for ConfigID {
    fn header_name() -> &'static str {
        CONFIGID_HEADER_NAME
    }

    fn parse_header(raw: &[Vec<u8>]) -> error::Result<Self> {
        if raw.len() != 1 {
            return Err(Error::Header);
        }

        let cow_str = String::from_utf8_lossy(&raw[0][..]);

        // Value needs to be a 31 bit non-negative integer, so convert to i32
        let value = match i32::from_str_radix(&*cow_str, 10) {
            Ok(n) => n,
            Err(_) => return Err(Error::Header),
        };

        // UPnP 1.1 spec says higher numbers are reserved for future use by the
        // technical committee. Devices should use numbers in the range 0 to
        // 16777215 (2^24-1) but I am not sure where the reserved numbers will
        // appear so we will ignore checking that the range is satisfied here.

        // Check if value is negative, then convert to u32
        if value.is_negative() {
            Err(Error::Header)
        } else {
            Ok(ConfigID(value as u32))
        }
    }
}

impl HeaderFormat for ConfigID {
    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::ConfigID;

    #[test]
    fn positive_configid() {
        let configid_header_value = &[b"1777215"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    fn positive_reserved() {
        let configid_header_value = &[b"20720000"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    fn positive_lower_bound() {
        let configid_header_value = &[b"0"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    fn positive_upper_bound() {
        let configid_header_value = &[b"2147483647"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    fn positive_negative_zero() {
        let configid_header_value = &[b"-0"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    #[should_panic]
    fn negative_overflow() {
        let configid_header_value = &[b"2290649224"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    #[should_panic]
    fn negative_negative_overflow() {
        let configid_header_value = &[b"-2290649224"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }

    #[test]
    #[should_panic]
    fn negative_nan() {
        let configid_header_value = &[b"2290wow649224"[..].to_vec()];

        ConfigID::parse_header(configid_header_value).unwrap();
    }
}