joyent/http-parserArchived
Http Parser
http-parser is a C library designed for zero-copy HTTP message parsing, URL deconstruction, and the management of protocol upgrades and chunked encoding. It provides utilities to extract headers, methods, and status codes from HTTP requests and responses.
The project includes a zero-copy URL parser for deconstructing strings into individual components and a mechanism for detecting protocol switch requests to identify the exact byte offset where non-HTTP data begins. It also features a decoder for handling chunked transfer-encoded data streams.
Features
- Message Parsing - Implements a zero-copy approach to extract header fields, status codes, and methods from HTTP requests and responses.
- Zero-Copy Parsing - Extracts data from input buffers by referencing pointers to the original memory instead of allocating new tokens.
- Chunked Transfer Encoding - Decodes data streams using chunked transfer encoding to retrieve the final response body.
- HTTP Message Parsers - Provides a C library for extracting headers, methods, and status codes using a high-performance zero-copy approach.
- URL Parsers - Offers a high-performance utility for deconstructing URL strings into individual components without memory allocation.
- Incremental Stream Processing - Processes incoming HTTP data incrementally in small chunks to avoid loading entire requests into memory.
- State-Based Parsing - Uses a state-machine based parsing technique to track context and handle byte streams incrementally.
- URL Component Deconstructors - Splits complex URL strings into constituent parts such as host, path, and query parameters.
- URL Data Parsing - Converts raw URL strings into structured components using a zero-copy utility.
- HTTP Upgrade Handlers - Handles the conversion of inbound HTTP requests into persistent connections by detecting protocol upgrade requests.
- Stream Offset Tracking - Tracks the exact byte position within the message stream to identify where protocol transitions occur.
- C Memory Management - Implements low-level memory allocation and cleanup for buffers within a C-based library to minimize overhead.
- Protocol Upgrades - Detects requests to switch protocols and identifies the byte offset where the new protocol stream begins.
- Development Utilities - C-based HTTP request/response parser.
