tower-http-client 0.6.0

Extra Tower middlewares and utilities for HTTP clients.
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

use http::{Uri, uri};
use private::Sealed;

/// A helper trait to try to convert some types into `Uri`.
///
/// This trait is sealed and implemented only for the most suitable types.
///
/// Unlike the similar trait in the Reqwest, this one describes a type's representation
/// that implements [`TryInto<Uri>`]. This approach can pass third-party types like `url::Url`
/// directly to the [`http::request::Builder::uri`] without any wrappers.
pub trait IntoUri: Sealed {
    /// Which kind of value should be converted to the Uri via [`TryInto<Uri>`]
    type TryInto;
    /// Converts this value into the input type for the [`TryInto<Uri>`] conversion.
    fn into_uri(self) -> Self::TryInto;
}

impl IntoUri for &Uri {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for Uri {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for String {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for &String {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for &str {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl<'a> IntoUri for &'a Vec<u8> {
    type TryInto = &'a [u8];

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for Vec<u8> {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for &[u8] {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

impl IntoUri for uri::Parts {
    type TryInto = Self;

    fn into_uri(self) -> Self::TryInto {
        self
    }
}

#[cfg(feature = "url")]
impl IntoUri for url::Url {
    type TryInto = String;

    fn into_uri(self) -> Self::TryInto {
        self.into()
    }
}

#[cfg(feature = "url")]
impl<'a> IntoUri for &'a url::Url {
    type TryInto = &'a str;

    fn into_uri(self) -> Self::TryInto {
        self.as_str()
    }
}

mod private {
    use http::{Uri, uri};
    #[cfg(feature = "url")]
    use url::Url;

    pub trait Sealed {}

    impl Sealed for uri::Parts {}
    impl Sealed for Uri {}
    impl Sealed for &Uri {}

    impl Sealed for String {}
    impl Sealed for &String {}
    impl Sealed for &str {}

    impl Sealed for Vec<u8> {}
    impl Sealed for &Vec<u8> {}
    impl Sealed for &[u8] {}

    #[cfg(feature = "url")]
    impl Sealed for Url {}
    #[cfg(feature = "url")]
    impl Sealed for &Url {}
}

#[cfg(feature = "url")]
#[cfg(test)]
mod tests {
    use http::Uri;
    use url::Url;

    use super::IntoUri as _;

    #[test]
    fn test_url_to_uri_smoke() {
        let example =
            "abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1";

        let url = Url::parse(example).unwrap();
        let expected_uri = Uri::from_static(example);

        let actual_uri: Uri = url.into_uri().parse().expect("failed to convert url");
        assert_eq!(actual_uri, expected_uri);
    }
}