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

# Protocol Support

This document summarizes protocol capabilities in `http-handle`.

## HTTP/2

- Feature: `http2`
- Implementation: `src/http2_server.rs`
- Capabilities:
  - h2c server start and connection handling
  - request mapping to internal request model
  - static file serving path support
  - protocol behavior tests in unit/integration suites

## HTTP/3 (QUIC Profile)

- Feature: `http3-profile`
- Implementation: `src/http3_profile.rs`
- Capabilities:
  - production baseline profile
  - QUIC runtime tuning presets (`Conservative`, `Balanced`, `Aggressive`)
  - ALPN route resolution (`h3`, `h2`, `http/1.1`)
  - client-offered ALPN selection with server-order policy
  - explicit fallback chain generation for graceful downgrade
  - decision tree with fallback reasons and telemetry line output

### HTTP/3 Conformance Tests

- Integration tests: `tests/http3_profile_conformance.rs`
- Covered paths:
  - ALPN matrix route stability
  - h3-handshake failure downgrade behavior
  - server-preferred ALPN policy enforcement

This keeps protocol negotiation and fallback behavior explicit while HTTP/3
transport integration remains modular.

## Connection Pooling

- Implementation: `ConnectionPool` in `src/server.rs`
- Features:
  - bounded acquisition
  - active count metrics
  - backpressure behavior tests

## Benchmark Coverage

- Benchmark target: `examples/bench.rs`
- Modes (selected via `HTTP_HANDLE_MODE`):
  - `sync`
  - `async`
  - `high-perf`
  - `high-perf-mt`
  - `http2`
- CI perf matrix: `.github/workflows/perf-regression.yml`