apollo-configuration 0.4.0

A typed, friendly configuration system for Apollo products.
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

//! Support for URL types in configuration.
//!
//! Provides a [`Url`] newtype with appropriate error handling.

use std::borrow::Cow;

use derive_more::{Deref, Display, From, FromStr};
use schemars::JsonSchema;
use serde::de::Deserializer;
use serde::{Deserialize, Serialize};

use crate::Validate;

/// A URL parsed from configuration.
#[derive(Debug, Clone, PartialEq, Eq, Hash, Deref, From, FromStr, Display)]
pub struct Url(url::Url);

impl<'de> Deserialize<'de> for Url {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let s = String::deserialize(deserializer)?;
        url::Url::parse(&s)
            .map(Self)
            .map_err(serde::de::Error::custom)
    }
}

impl Serialize for Url {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        self.0.as_str().serialize(serializer)
    }
}

impl AsRef<str> for Url {
    fn as_ref(&self) -> &str {
        self.0.as_ref()
    }
}

impl JsonSchema for Url {
    fn schema_name() -> Cow<'static, str> {
        Cow::Borrowed("Url")
    }

    fn json_schema(generator: &mut schemars::SchemaGenerator) -> schemars::Schema {
        url::Url::json_schema(generator)
    }
}

impl Validate for Url {}