hyperlane-core 22.0.6

A lightweight, high-performance, and cross-platform Rust HTTP server library built on Tokio. It simplifies modern web service development by providing built-in support for middleware, WebSocket, Server-Sent Events (SSE), and raw TCP communication. With a unified and ergonomic API across Windows, Linux, and MacOS, it enables developers to build robust, scalable, and event-driven network applications with minimal overhead and maximum flexibility.
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

use super::*;

/// TLS material a server needs to terminate a connection.
///
/// The certificate and key are stored as filesystem paths and only read when a
/// listener is created, so a configuration can be deserialized, compared and
/// cloned without touching the disk.
///
/// The two path fields are part of the public surface: `TlsConfig::new` is the
/// documented constructor and applications read back what they configured.
#[derive(Clone, CustomDebug, Data, Deserialize, DisplayDebug, Eq, New, PartialEq, Serialize)]
pub struct TlsConfig {
    /// Path to the PEM encoded certificate chain presented to clients.
    pub certificate_path: String,
    /// Path to the PEM encoded private key matching the leaf certificate.
    pub private_key_path: String,
}

/// Represents the server configuration.
///
/// This structure holds all the settings for the HTTP and WebSocket server,
/// including network parameters and buffer sizes.
#[derive(Clone, CustomDebug, Data, Deserialize, DisplayDebug, Eq, New, PartialEq, Serialize)]
pub struct ServerConfig {
    /// The address the server will bind to.
    #[set(type(AsRef<str>))]
    pub address: String,
    /// The `TCP_NODELAY` option for sockets.
    #[get(type(copy))]
    pub nodelay: Option<bool>,
    /// The `IP_TTL` option for sockets.
    #[get(type(copy))]
    pub ttl: Option<u32>,
    /// The wire protocol the listener speaks, defaulting to HTTP/1.
    ///
    /// Skipped by `new` so the three argument constructor keeps its signature;
    /// a configuration built that way speaks HTTP/1 until a setter changes it.
    #[get(type(copy))]
    #[new(skip)]
    #[serde(default)]
    pub protocol: ServerProtocol,
    /// TLS material used to terminate connections, or `None` for plaintext.
    ///
    /// Skipped by `new` for the same reason as `protocol`; the setters take an
    /// `Option`, so `set_tls(None)` restores plaintext without a separate call.
    #[get(type(clone))]
    #[new(skip)]
    #[serde(default)]
    pub tls: Option<TlsConfig>,
}