# into_url.rs - source
Source of the Rust file `/home/runner/.cargo/registry/src/github.com-1ecc6299db9ec823/reqwest-0.11.2/src/into_url.rs`.
Keywords: rust, rustlang, rust-lang

     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

    use url::Url;

    /// A trait to try to convert some type into a `Url`.
    ///
    /// This trait is "sealed", such that only types within reqwest can
    /// implement it.
    pub trait IntoUrl: IntoUrlSealed {}

    impl IntoUrl for Url {}
    impl IntoUrl for String {}
    impl<'a> IntoUrl for &'a str {}
    impl<'a> IntoUrl for &'a String {}

    pub trait IntoUrlSealed {
        // Besides parsing as a valid `Url`, the `Url` must be a valid
        // `http::Uri`, in that it makes sense to use in a network request.
        fn into_url(self) -> crate::Result<Url>;

        fn as_str(&self) -> &str;
    }

    impl IntoUrlSealed for Url {
        fn into_url(self) -> crate::Result<Url> {
            if self.has_host() {
                Ok(self)
            } else {
                Err(crate::error::url_bad_scheme(self))
            }
        }

        fn as_str(&self) -> &str {
            self.as_ref()
        }
    }

    impl<'a> IntoUrlSealed for &'a str {
        fn into_url(self) -> crate::Result<Url> {
            Url::parse(self).map_err(crate::error::builder)?.into_url()
        }

        fn as_str(&self) -> &str {
            self
        }
    }

    impl<'a> IntoUrlSealed for &'a String {
        fn into_url(self) -> crate::Result<Url> {
            (&**self).into_url()
        }

        fn as_str(&self) -> &str {
            self.as_ref()
        }
    }

    impl<'a> IntoUrlSealed for String {
        fn into_url(self) -> crate::Result<Url> {
            (&*self).into_url()
        }

        fn as_str(&self) -> &str {
            self.as_ref()
        }
    }

    if_hyper! {
        pub(crate) fn expect_uri(url: &Url) -> http::Uri {
            url.as_str()
                .parse()
                .expect("a parsed Url should always be a valid Uri")
        }

        pub(crate) fn try_uri(url: &Url) -> Option<http::Uri> {
            url.as_str().parse().ok()
        }
    }

    #[cfg(test)]
    mod tests {
        use super::*;

        #[test]
        fn into_url_file_scheme() {
            let err = "file:///etc/hosts".into_url().unwrap_err();
            assert_eq!(
                err.to_string(),
                "builder error for url (file:///etc/hosts): URL scheme is not allowed"
            );
        }
    }