rust-web-server 18.8.2

Single-binary web server and reverse proxy: automatic HTTPS (Let's Encrypt), HTTP/1.1, HTTP/2 and HTTP/3, load balancing, auth and rate limiting, configured in one TOML file. Also a Rust library: routing, middleware, MCP server, ORM, background jobs. No hyper, no Tower; HTTP/2 and HTTP/3 framing via h2 and quinn.
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

//! `Application::runs_inline` across the built-in wrappers: a request runs on
//! the event loop only when every layer opts in.

use crate::app::App;
use crate::application::Application;
use crate::core::New;
use crate::middleware::{Middleware, WithMiddleware};
use crate::request::Request;
use crate::response::Response;
use crate::server::{Address, ConnectionInfo};

fn conn() -> ConnectionInfo {
    ConnectionInfo {
        client: Address { ip: "127.0.0.1".to_string(), port: 1 },
        server: Address { ip: "127.0.0.1".to_string(), port: 2 },
        request_size: 1024,
        sni_hostname: None,
    }
}

fn req(method: &str, uri: &str) -> Request {
    Request { method: method.to_string(), request_uri: uri.to_string(), http_version: "HTTP/1.1".to_string(), headers: vec![], body: Default::default() }
}

/// A user layer that doesn't declare itself non-blocking.
struct UserLayer;
impl Middleware for UserLayer {
    fn handle(&self, request: &Request, connection: &ConnectionInfo, next: &dyn Application) -> Result<Response, String> {
        next.execute(request, connection)
    }
}

#[test]
fn app_runs_get_and_head_inline_but_not_posts() {
    let app = App::new();
    assert!(app.runs_inline(&req("GET", "/healthz"), &conn()));
    assert!(app.runs_inline(&req("HEAD", "/index.html"), &conn()));
    assert!(!app.runs_inline(&req("POST", "/file-upload/initiate"), &conn()));
}

#[test]
fn middleware_stack_runs_inline_only_if_every_layer_opts_in() {
    let built_in = WithMiddleware::new(App::new()).wrap(crate::middleware::RateLimitLayer).wrap(crate::request_id::RequestIdLayer::new());
    assert!(built_in.runs_inline(&req("GET", "/healthz"), &conn()));
    let with_user_layer = WithMiddleware::new(App::new()).wrap(crate::middleware::RateLimitLayer).wrap(UserLayer);
    assert!(!with_user_layer.runs_inline(&req("GET", "/healthz"), &conn()));
}

#[test]
fn user_routes_never_run_inline() {
    fn handler(_: &Request, _: &crate::router::PathParams, _: &ConnectionInfo, _: &()) -> Response {
        Response::new()
    }
    let app = App::with_state(()).get("/api/users", handler);
    assert!(!app.runs_inline(&req("GET", "/api/users"), &conn()), "a route handler is user code");
    assert!(app.runs_inline(&req("GET", "/healthz"), &conn()), "unmatched requests fall through to App");
}

#[test]
fn proxy_routes_never_run_inline() {
    let config = crate::proxy_config::ProxyConfig::from_str(r#"
[[route]]
  [route.match]
  path = "/api/*"
  [route.action]
  type     = "proxy"
  upstream = "127.0.0.1:9"
"#);
    let (app, _) = crate::proxy_config::builder::build(config);
    assert!(!app.runs_inline(&req("GET", "/api/x"), &conn()));
    assert!(app.runs_inline(&req("GET", "/healthz"), &conn()));
}

#[test]
fn mcp_calls_never_run_inline() {
    let mcp = crate::mcp::McpServer::new("t", "1");
    assert!(!mcp.runs_inline(&req("POST", "/mcp"), &conn()));
    assert!(!mcp.runs_inline(&req("GET", "/mcp"), &conn()), "GET /mcp is a long-lived SSE stream");
    assert!(mcp.runs_inline(&req("GET", "/healthz"), &conn()));
}