klauthed-core 0.3.0

Core primitives for klauthed: typed config, clock/time, request context, CQRS, domain, and validation.
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

//! HTTP server configuration (`ServerConfig`).

use serde::{Deserialize, Serialize};

/// HTTP server binding and runtime settings (e.g. for an actix-web service).
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ServerConfig {
    /// Bind address (default `0.0.0.0`).
    #[serde(default = "default_host")]
    pub host: String,
    /// Bind port (default `8080`).
    #[serde(default = "default_port")]
    pub port: u16,
    /// Worker thread count; `None` lets the server pick (usually CPU count).
    #[serde(default)]
    pub workers: Option<usize>,
    /// Per-request timeout in seconds.
    #[serde(default = "default_request_timeout_secs")]
    pub request_timeout_secs: u64,
    /// Whether the server terminates TLS itself.
    #[serde(default)]
    pub tls: bool,
}

fn default_host() -> String {
    "0.0.0.0".to_owned()
}
fn default_port() -> u16 {
    8080
}
fn default_request_timeout_secs() -> u64 {
    30
}

impl Default for ServerConfig {
    fn default() -> Self {
        Self {
            host: default_host(),
            port: default_port(),
            workers: None,
            request_timeout_secs: default_request_timeout_secs(),
            tls: false,
        }
    }
}

impl ServerConfig {
    /// The `host:port` string suitable for binding a listener.
    pub fn bind_address(&self) -> String {
        format!("{}:{}", self.host, self.port)
    }
}

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

    #[test]
    fn defaults_and_bind_address() {
        let cfg: ServerConfig = serde_json::from_value(json!({})).unwrap();
        assert_eq!(cfg.bind_address(), "0.0.0.0:8080");
        assert_eq!(cfg.request_timeout_secs, 30);
    }

    #[test]
    fn overrides_apply() {
        let cfg: ServerConfig =
            serde_json::from_value(json!({ "host": "127.0.0.1", "port": 9000 })).unwrap();
        assert_eq!(cfg.bind_address(), "127.0.0.1:9000");
    }
}