hyper 0.3.1

A modern HTTP library.
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

//! HTTP RequestUris
use std::str::FromStr;
use url::Url;
use url::ParseError as UrlError;

use error::HttpError;

/// The Request-URI of a Request's StartLine.
///
/// From Section 5.3, Request Target:
/// > Once an inbound connection is obtained, the client sends an HTTP
/// > request message (Section 3) with a request-target derived from the
/// > target URI.  There are four distinct formats for the request-target,
/// > depending on both the method being requested and whether the request
/// > is to a proxy.
/// >
/// > ```notrust
/// > request-target = origin-form
/// >                / absolute-form
/// >                / authority-form
/// >                / asterisk-form
/// > ```
#[derive(Debug, PartialEq, Clone)]
pub enum RequestUri {
    /// The most common request target, an absolute path and optional query.
    ///
    /// For example, the line `GET /where?q=now HTTP/1.1` would parse the URI
    /// as `AbsolutePath("/where?q=now".to_string())`.
    AbsolutePath(String),

    /// An absolute URI. Used in conjunction with proxies.
    ///
    /// > When making a request to a proxy, other than a CONNECT or server-wide
    /// > OPTIONS request (as detailed below), a client MUST send the target
    /// > URI in absolute-form as the request-target.
    ///
    /// An example StartLine with an `AbsoluteUri` would be
    /// `GET http://www.example.org/pub/WWW/TheProject.html HTTP/1.1`.
    AbsoluteUri(Url),

    /// The authority form is only for use with `CONNECT` requests.
    ///
    /// An example StartLine: `CONNECT www.example.com:80 HTTP/1.1`.
    Authority(String),

    /// The star is used to target the entire server, instead of a specific resource.
    ///
    /// This is only used for a server-wide `OPTIONS` request.
    Star,
}

impl FromStr for RequestUri {
    type Err = HttpError;

    fn from_str(s: &str) -> Result<RequestUri, HttpError> {
        match s.as_bytes() {
            [] => Err(HttpError::HttpUriError(UrlError::InvalidCharacter)),
            [b'*'] => Ok(RequestUri::Star),
            [b'/', ..] => Ok(RequestUri::AbsolutePath(s.to_string())),
            bytes if bytes.contains(&b'/') => {
                Ok(RequestUri::AbsoluteUri(try!(Url::parse(s))))
            }
            _ => {
                let mut temp = "http://".to_string();
                temp.push_str(s);
                try!(Url::parse(&temp[..]));
                todo!("compare vs u.authority()");
                Ok(RequestUri::Authority(s.to_string()))
            }

        }
    }
}

#[test]
fn test_uri_fromstr() {
    use error::HttpResult;
    fn read(s: &str, result: HttpResult<RequestUri>) {
        assert_eq!(s.parse(), result);
    }

    read("*", Ok(RequestUri::Star));
    read("http://hyper.rs/", Ok(RequestUri::AbsoluteUri(Url::parse("http://hyper.rs/").unwrap())));
    read("hyper.rs", Ok(RequestUri::Authority("hyper.rs".to_string())));
    read("/", Ok(RequestUri::AbsolutePath("/".to_string())));
}