goose-http 0.1.0

HTTP/1.1 server for Rust implementing RFC 9110/9111/9112 semantics, caching, and range handling
Documentation

Goose HTTP

Goose HTTP is a from-scratch implementation of an HTTP/1.1 server written in Rust. It adheres to the 2022 HTTPbis specification split:

The project is intentionally minimal but complete—it implements message framing, request parsing, conditional requests, Range handling, caching semantics, connection management, and a fully asynchronous runtime using Tokio.

Getting Started

Prerequisites

  • Rust toolchain (1.75+ recommended)
  • cargo for building and running

Building

cargo build

Example Harness

cargo run --bin compliance_harness -- --help

The compliance harness binds to 127.0.0.1:18080 by default and exposes sample routes that exercise validators, range requests, and caching semantics. It is used to drive the conformance suites under scripts/compliance/.

Testing

cargo test

Unit tests cover parsers, caching helpers, and range utilities. Integration tests in tests/http_flow.rs spin up the server to verify Expect: 100-continue, pipelined responses, and multi-range responses end-to-end.

Project Layout

  • src/conn/: Connection state machine, keep-alive & pipelining logic, timeout handling, conditional request evaluation.
  • src/parse/: Request-line, header parsing, and body framing (Content-Length & chunked) strictly following RFC 9112.
  • src/encode/: Response serialization including chunked transfer-coding, trailers, and mandatory headers (Date, Connection).
  • src/cache/: Cache-Control parsing, freshness calculations, Age defaults.
  • src/range/: Range header parsing and satisfiable range computation.
  • src/request/ & src/response/: Typed representations of HTTP messages with convenience builders.
  • src/server/: Tokio accept loop, connection orchestration, configurable timeouts and structured logging.
  • src/log/: Tracing-based logging façade with lazy initialisation.
  • src/bin/compliance_harness.rs: Compliance test harness used for automated suites.

Logging & Diagnostics

Logging is powered by the tracing crate. Call goose_http::log::init() once during application startup (the demo binary does this automatically). Environment-based filtering is supported via RUST_LOG.

License

This project is released under the CC0-1.0 license. See LICENSE for details.