url-cleaner-engine 0.11.0

The engine behind URL Cleaner.
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

//! Various "glue"s to integrate with other crates for advanced features.

#[cfg(feature = "regex"   )] pub mod regex;
#[cfg(feature = "regex"   )] pub use regex::*;
#[cfg(feature = "commands")] pub mod command;
#[cfg(feature = "commands")] pub use command::*;
#[cfg(feature = "http"    )] pub mod http_client_config;
#[cfg(feature = "http"    )] pub use http_client_config::*;
#[cfg(feature = "http"    )] pub mod proxy;
#[cfg(feature = "http"    )] pub use proxy::*;
#[cfg(feature = "http"    )] pub mod http;
#[cfg(feature = "http"    )] pub use http::*;
#[cfg(feature = "http"    )] pub mod json;
#[cfg(feature = "http"    )] pub use json::*;
#[cfg(feature = "cache"   )] pub mod caching;
#[cfg(feature = "cache"   )] pub use caching::*;
#[cfg(feature = "base64"  )] pub mod base64;
#[cfg(feature = "base64"  )] pub use base64::*;

// Intentionally not glob re-exported.
pub mod parse;
pub mod percent_encoding;
pub use percent_encoding::*;
pub mod url_position;
pub use url_position::*;

/// Glue to allow [`reqwest::header::HeaderValue`] to be used with serde.
#[cfg(feature = "http")]
pub(crate) mod serde_headervalue {
    use serde::{Deserialize, ser::{Serializer, Error as _}, de::{Deserializer, Error as _}};
    use reqwest::header::HeaderValue;

    /// Deserializes a [`HeaderValue`].
    /// # Errors
    /// If the value isn't a string or isn't a valid [`HeaderValue`], returns an error.
    pub(crate) fn deserialize<'de, D: Deserializer<'de>>(d: D) -> Result<HeaderValue, D::Error> {
        let temp: String = Deserialize::deserialize(d)?;
        temp.try_into().map_err(D::Error::custom)
    }

    /// Serializes a [`HeaderValue`].
    /// # Errors
    /// If the call to [`HeaderValue::to_str`] returns an error, that error is returned.
    pub(crate) fn serialize<S: Serializer>(x: &HeaderValue, s: S) -> Result<S::Ok, S::Error> {
        s.serialize_str(x.to_str().map_err(S::Error::custom)?)
    }
}

/// Glue to allow [`reqwest::header::HeaderMap`] to be used with serde.
#[cfg(feature = "http")]
pub(crate) mod serde_headermap {
    use std::collections::HashMap;

    use serde::{Deserialize, ser::{Serializer, Error as _}, de::{Deserializer, Error as _}};
    use reqwest::header::HeaderMap;

    /// Deserializes a [`HeaderMap`].
    /// # Errors
    /// If the value isn't a map or isn't a valid [`HeaderMap`], returns an error.
    pub(crate) fn deserialize<'de, D: Deserializer<'de>>(d: D) -> Result<HeaderMap, D::Error> {
        let temp: HashMap<String, String> = Deserialize::deserialize(d)?;
        (&temp).try_into().map_err(D::Error::custom)
    }

    /// Serializes a [`HeaderMap`].
    /// # Errors
    /// Never returns an error.
    pub(crate) fn serialize<S: Serializer>(x: &HeaderMap, s: S) -> Result<S::Ok, S::Error> {
        s.collect_map(x.into_iter().map(|(k, v)| v.to_str().map(|v| (k.as_str().to_string(), v.to_string()))).collect::<Result<HashMap<_, _>, _>>().map_err(S::Error::custom)?)
    }
}