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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

[package]
name = "httpsd"
version = "0.1.0"
edition = "2024"
rust-version = "1.88"
description = "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."
repository = "https://github.com/KarpelesLab/httpsd"
license = "MIT"
keywords = ["http", "https", "server", "tls", "sans-io"]
categories = ["network-programming", "web-programming::http-server"]
readme = "README.md"

[lib]
name = "httpsd"

[[bin]]
name = "httpsd"
required-features = ["cli"]

[features]
# The default build is a complete, self-contained HTTPS server CLI: a worker
# thread pool, TLS, HTTP/2, response compression, and TOML config loading.
default = ["cli", "rt-threadpool", "tls", "compress", "h2", "h3"]

# TLS / HTTPS support, built on the sans-I/O `purecrypto::tls` engine.
tls = ["dep:purecrypto"]
# Response compression (gzip / deflate / zlib) via `compcol`.
compress = ["dep:compcol"]
# HTTP/2 (RFC 9113) over TLS, negotiated via ALPN. HPACK comes from `compcol`.
h2 = ["tls", "dep:compcol", "compcol/hpack"]
# HTTP/3 (RFC 9114) over QUIC/UDP. QUIC comes from `purecrypto`, QPACK from
# `compcol`. Brings its own UDP server loop (see `Server::run_h3`).
h3 = ["tls", "dep:compcol", "compcol/qpack", "compcol/hpack"]
# Automatic TLS certificates via ACME (Let's Encrypt et al.): on-demand
# issuance keyed on SNI, TLS-ALPN-01 + HTTP-01 challenges, on-disk persistence.
# Uses `rsurl` as the ACME HTTP client.
acme = ["tls", "dep:rsurl"]
# TOML configuration file loading.
config = ["dep:serde", "dep:toml"]
# The `httpsd` command-line binary. Pulls in config + the thread-pool runtime
# unless another runtime is selected.
cli = ["config", "rt-threadpool"]

# --- runtime drivers (pick one or more; all drive the same sans-I/O core) ---
# Blocking std::net listener backed by a fixed worker thread pool.
rt-threadpool = []
# Asynchronous runtime built on tokio.
rt-tokio = ["dep:tokio"]
# Single-/few-thread readiness event loop built on mio.
rt-mio = ["dep:mio"]

[dependencies]
# purecrypto's `tls` module pulls in DTLS/QUIC paths that are wired to the
# default feature set, so we use its defaults rather than cherry-picking.
purecrypto = { version = "0.6.25", optional = true }
compcol = { version = "0.6.5", optional = true, default-features = false, features = ["std", "gzip", "deflate", "zlib"] }
serde = { version = "1", optional = true, features = ["derive"] }
toml = { version = "0.8", optional = true }
tokio = { version = "1", optional = true, features = ["rt", "rt-multi-thread", "net", "io-util", "macros"] }
mio = { version = "1", optional = true, features = ["os-poll", "net"] }
rsurl = { version = "0.1.2", optional = true }

[dev-dependencies]
purecrypto = "0.6.25"
compcol = { version = "0.6.5", default-features = false, features = ["std", "gzip"] }

[package.metadata.docs.rs]
all-features = true