http-handle 0.0.5

A fast and lightweight Rust library for handling HTTP requests and responses.
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2023 - 2026 HTTP Handle

//! `ServerBuilder`: fluent configuration without starting the listener.
//!
//! Run: `cargo run --example builder`

#[path = "support.rs"]
mod support;

use http_handle::Server;
use std::collections::HashMap;
use std::time::Duration;

fn main() {
    support::header("http-handle -- builder");

    support::task_with_output("CORS-enabled server", || {
        let s = Server::builder()
            .address("127.0.0.1:8081")
            .document_root("examples")
            .enable_cors()
            .cors_origins(vec![
                "https://localhost:3000".into(),
                "https://example.com".into(),
            ])
            .build()
            .expect("build");
        vec![format!("addr = {}", s.address()), "cors = on".into()]
    });

    support::task_with_output("Per-header security hardening", || {
        let _ = Server::builder()
            .address("127.0.0.1:8082")
            .document_root("examples")
            .custom_header("X-Content-Type-Options", "nosniff")
            .custom_header("X-Frame-Options", "DENY")
            .custom_header("X-XSS-Protection", "1; mode=block")
            .build()
            .expect("build");
        vec![
            "X-Content-Type-Options: nosniff".into(),
            "X-Frame-Options: DENY".into(),
            "X-XSS-Protection: 1; mode=block".into(),
        ]
    });

    support::task_with_output(
        "Custom request / connection timeouts",
        || {
            let _ = Server::builder()
                .address("127.0.0.1:8083")
                .document_root("examples")
                .request_timeout(Duration::from_secs(30))
                .connection_timeout(Duration::from_secs(60))
                .build()
                .expect("build");
            vec![
                "request_timeout    = 30s".into(),
                "connection_timeout = 60s".into(),
            ]
        },
    );

    support::task_with_output(
        "Bulk header insertion via HashMap",
        || {
            let mut headers = HashMap::new();
            let _ =
                headers.insert("X-Api-Version".into(), "v1.0".into());
            let _ =
                headers.insert("X-Rate-Limit".into(), "1000".into());
            let _ = Server::builder()
                .address("127.0.0.1:8084")
                .document_root("examples")
                .custom_headers(headers)
                .build()
                .expect("build");
            vec!["headers inserted via HashMap".into()]
        },
    );

    support::task_with_output(
        "CORS toggle (enable then disable)",
        || {
            let _ = Server::builder()
                .address("127.0.0.1:8086")
                .document_root("examples")
                .enable_cors()
                .cors_origins(vec!["https://localhost".into()])
                .disable_cors()
                .build()
                .expect("build");
            vec!["cors = off (disable_cors() wins)".into()]
        },
    );

    let err = support::task(
        "Required-field validation surfaces errors",
        || {
            Server::builder()
                .address("127.0.0.1:8087")
                // missing document_root → must fail
                .build()
                .err()
                .map(|e| e.to_string())
                .unwrap_or_default()
        },
    );
    println!("    \x1b[90merr = {err}\x1b[0m");

    support::summary(6);
}