httpsd 0.1.0

A pure-Rust HTTP/HTTPS server — usable as a sans-I/O library with pluggable runtimes (thread pool, tokio, mio) or as a CLI that serves a directory or a TOML config.
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

//! HTTP protocol versions.

use std::fmt;

/// The HTTP version from the request line.
///
/// Only the HTTP/1.x family is parsed by this engine; `HTTP/2` and `HTTP/3`
/// use entirely different framing and are out of scope.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Version {
    /// HTTP/1.0 — connections close by default unless `Connection: keep-alive`.
    Http10,
    /// HTTP/1.1 — connections persist by default unless `Connection: close`.
    Http11,
    /// HTTP/2 (RFC 9113) — binary, multiplexed; framing replaces the textual
    /// request line. Carried on a connection negotiated via ALPN.
    Http2,
    /// HTTP/3 (RFC 9114) — like HTTP/2 but carried over QUIC streams.
    Http3,
}

impl Version {
    /// Parse the `HTTP/x.y` token from a request line.
    pub fn parse(token: &str) -> Option<Version> {
        match token {
            "HTTP/1.0" => Some(Version::Http10),
            "HTTP/1.1" => Some(Version::Http11),
            _ => None,
        }
    }

    /// The wire representation, e.g. `"HTTP/1.1"`.
    pub fn as_str(self) -> &'static str {
        match self {
            Version::Http10 => "HTTP/1.0",
            Version::Http11 => "HTTP/1.1",
            Version::Http2 => "HTTP/2",
            Version::Http3 => "HTTP/3",
        }
    }

    /// Whether persistent connections are the default for this version.
    pub fn default_keep_alive(self) -> bool {
        matches!(self, Version::Http11 | Version::Http2 | Version::Http3)
    }
}

impl fmt::Display for Version {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.as_str())
    }
}