credence-lib 0.0.6

An unfussy web server designed for straightforward authoring and scalable performance
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

use super::{super::error::*, host::*};

use {
    compris::resolve::*,
    kutil::{
        cli::depict::*,
        io::network::ip::*,
        std::{immutable::*, sync::*},
    },
    std::{io, net::*, path::*, vec},
};

//
// Port
//

/// Port.
#[derive(Clone, Debug, Depict, Resolve)]
pub struct Port {
    /// Index.
    #[depict(style(number))]
    pub index: usize,

    /// Name. Will default to a string representation of the index.
    #[resolve]
    #[depict(style(string))]
    pub name: ByteString,

    /// Optional address or hint.
    ///
    /// See [ListenableAddressesConfiguration::addresses] where `allow_unspecified` is false.
    #[resolve]
    #[depict(option, as(display), style(string))]
    pub address: Option<IpAddr>,
    /// Optional zone for IPv6 address.
    #[resolve]
    #[depict(option, style(string))]
    pub zone: Option<ByteString>,

    /// Optional flowinfo for IPv6 address.
    #[resolve]
    #[depict(option, style(number))]
    pub flowinfo: Option<u32>,

    /// Whether to include loopbacks when providing reachable addresses.
    ///
    /// Default is true.
    #[resolve(key = "include-loopbacks")]
    #[depict(style(symbol))]
    pub include_loopbacks: bool,

    /// Hosts.
    #[resolve]
    #[depict(iter(item), as(depict))]
    pub hosts: Vec<Host>,
}

static COUNTER: Counter = Counter::new();

impl Default for Port {
    fn default() -> Self {
        let index = COUNTER.next();
        Self {
            index,
            name: index.to_string().into(),
            address: None,
            zone: None,
            flowinfo: None,
            include_loopbacks: true,
            hosts: Default::default(),
        }
    }
}

impl Port {
    /// Validate.
    pub fn validate<PathT>(&mut self, base_path: PathT) -> Result<(), ConfigurationError>
    where
        PathT: AsRef<Path>,
    {
        let base_path = base_path.as_ref();
        for host in &mut self.hosts {
            host.validate(base_path)?;
        }
        Ok(())
    }

    /// Whether any of the hosts has TLS.
    pub fn is_tls(&self) -> bool {
        for host in &self.hosts {
            if host.has_tls() {
                return true;
            }
        }
        false
    }

    /// Create a [ListenablePortConfiguration].
    pub fn listenable_port_configuration(&self, port: u16) -> ListenablePortConfiguration {
        ListenablePortConfiguration::new(
            port,
            self.address,
            self.zone.clone().map(|zone| zone.into()),
            self.flowinfo,
            false,
            self.include_loopbacks,
        )
    }

    /// To [SocketAddr]s.
    pub fn socket_addresses(&self, port: u16) -> io::Result<vec::IntoIter<SocketAddr>> {
        self.listenable_port_configuration(port).to_socket_addrs()
    }
}