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
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

//! Support for socket address types in configuration.

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;

// =============================================================================
// SocketAddr
// =============================================================================

/// A socket address (v4 or v6) parsed from configuration.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Deref, From, FromStr, Display)]
pub struct SocketAddr(std::net::SocketAddr);

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

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

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

    fn json_schema(generator: &mut schemars::SchemaGenerator) -> schemars::Schema {
        std::net::SocketAddr::json_schema(generator)
    }
}

impl Validate for SocketAddr {}

// =============================================================================
// SocketAddrV4
// =============================================================================

/// An IPv4 socket address parsed from configuration.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Deref, From, FromStr, Display)]
pub struct SocketAddrV4(std::net::SocketAddrV4);

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

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

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

    fn json_schema(generator: &mut schemars::SchemaGenerator) -> schemars::Schema {
        std::net::SocketAddrV4::json_schema(generator)
    }
}

impl Validate for SocketAddrV4 {}

// =============================================================================
// SocketAddrV6
// =============================================================================

/// An IPv6 socket address parsed from configuration.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Deref, From, FromStr, Display)]
pub struct SocketAddrV6(std::net::SocketAddrV6);

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

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

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

    fn json_schema(generator: &mut schemars::SchemaGenerator) -> schemars::Schema {
        std::net::SocketAddrV6::json_schema(generator)
    }
}

impl Validate for SocketAddrV6 {}