How seanmonstar/warp works
Warp is a composable Rust web-server framework. A developer builds request requirements from filters; at runtime the server accepts requests, adapts each request into a service, evaluates the filter chain, and turns a reply or rejection into an HTTP response. Built-in filters cover routing, request metadata and bodies, static files, WebSockets, logging, CORS, compression, and streaming responses. Source excerpts show the server-to-service and service-to-route/reply path; README statements support the broader filter capabilities, whose internal wiring was not sampled.
Main entry points: mod.rs Filter composition · service.rs Filter service · server.rs HTTP server · reply.rs Reply conversion
Components 19
Server runtime
- HTTP server
src/server.rs - Filter service
src/filter/service.rs - Request route state
src/route.rs
Filter composition
- Filter composition
src/filter/mod.rs - Extraction tuples
src/generic.rs
Request filters
- Path routing
src/filters/path.rs - Header filters
src/filters/header.rs - Body decoding
src/filters/body.rs - Multipart forms
src/filters/multipart.rs - Query extraction
src/filters/query.rs - Static files
src/filters/fs.rs - WebSockets
src/filters/ws.rs
Responses and middleware
- CORS
src/filters/cors.rs - Compression
src/filters/compression.rs - Access logging
src/filters/log.rs - Streaming replies
src/filters/sse.rs - Reply conversion
src/reply.rs - Rejection handling
src/reject.rs
Other components
- HTTP client
Connections 19
- HTTP client → HTTP server: sends requests
- HTTP server → Filter service: creates per-request
src/server.rs - Filter service → Request route state: sets request context
src/filter/service.rs - Filter service → Filter composition: evaluates filter
src/filter/service.rs - Filter service → Reply conversion: converts success
src/filter/service.rs - Filter service → Rejection handling: converts rejection
src/filter/service.rs - Filter composition → Extraction tuples: combines extractions
src/filter/mod.rs - Filter composition → Path routing: composes routing
src/filters/path.rs - Filter composition → Header filters: composes requirements
src/filters/header.rs - Filter composition → Body decoding: composes body filters
src/filters/body.rs - Filter composition → Multipart forms: composes form filters
src/filters/multipart.rs - Filter composition → Query extraction: composes extraction
src/filters/query.rs - Filter composition → Static files: composes file serving
src/filters/fs.rs - Filter composition → WebSockets: composes upgrades
src/filters/ws.rs - Filter composition → CORS: composes middleware
src/filters/cors.rs - Filter composition → Compression: composes compression
src/filters/compression.rs - Filter composition → Access logging: composes logging
src/filters/log.rs - Filter composition → Streaming replies: composes streaming
src/filters/sse.rs - Reply conversion → Rejection handling: handles failed matches
src/reject.rs