diff --git a/docs/content/news.md b/docs/content/news.md index 6315a88c..51f37e0c 100644 --- a/docs/content/news.md +++ b/docs/content/news.md @@ -3,6 +3,14 @@ ## unreleased +### New Features + +- **Fast HTTP Parser (gunicorn_h1c 0.4.1)**: Integrate new exception types and limit + parameters from gunicorn_h1c 0.4.1 for both WSGI and ASGI workers + - Requires gunicorn_h1c >= 0.4.1 for `http_parser='fast'` + - Falls back to Python parser in `auto` mode if version not met + - Proper HTTP status codes for limit errors (414, 431) + ### Performance - **ASGI HTTP Parser Optimizations**: Improve ASGI worker HTTP parsing performance diff --git a/docs/content/reference/settings.md b/docs/content/reference/settings.md index 84ddd16c..cb0adf78 100644 --- a/docs/content/reference/settings.md +++ b/docs/content/reference/settings.md @@ -1978,15 +1978,14 @@ This setting only affects the ``asgi`` worker type. **Default:** `'auto'` -HTTP parser implementation for ASGI workers. +HTTP parser implementation for WSGI and ASGI workers. -- auto: Use H1CProtocol if gunicorn_h1c is available, else PythonProtocol (default) -- fast: Require H1CProtocol from gunicorn_h1c (fail if unavailable) -- python: Force pure Python PythonProtocol parser +- auto: Use gunicorn_h1c if available (>= 0.4.1), else pure Python parser (default) +- fast: Require gunicorn_h1c >= 0.4.1 (fail if unavailable) +- python: Force pure Python parser -ASGI workers use callback-based parsing in data_received() for efficient -incremental parsing. The gunicorn_h1c C extension provides significantly -faster HTTP parsing using picohttpparser with SIMD optimizations. +The gunicorn_h1c C extension provides faster HTTP parsing using picohttpparser +with SIMD optimizations. Requires gunicorn_h1c >= 0.4.1 for limit enforcement. Install it with: pip install gunicorn[fast]