To help you get started, we've collected the most common ways that waitress is being used within popular public projects.

Pylons / waitress / tests / test_functional.py View on Github

"Connection: Keep-Alive\r\n"
            "Content-Length: 0\r\n"
            "\r\n"
        )
        self.connect()
        self.sock.send(to_send)
        fp = self.sock.makefile("rb", 0)
        line = fp.readline()  # status line
        version, status, reason = (x.strip() for x in line.split(None, 2))
        headers = parse_headers(fp)
        content_length = int(headers.get("content-length"))
        response_body = fp.read(content_length)
        self.assertEqual(int(status), 200)
        self.assertNotEqual(content_length, len(response_body))
        self.assertEqual(len(response_body), content_length - 1)
        self.assertEqual(response_body, tobytes("abcdefghi"))
        # remote closed connection (despite keepalive header); not sure why
        # first send succeeds
        self.send_check_error(to_send)
        self.assertRaises(ConnectionClosed, read_http, fp)

View more ways to use waitress

Waitress

Waitress is a production-quality pure-Python WSGI server with very acceptable performance. It has no dependencies except ones which live in the Python standard library. It runs on CPython on Unix and Windows under Python 3.9+. It is also known to run on PyPy 3 (version 3.9 compatible python and above) on UNIX. It supports HTTP/1.0 and HTTP/1.1.

For more information, see the "docs" directory of the Waitress package or visit

3.0.2 (2024-11-16)

Security

• When using Waitress to process trusted proxy headers, Waitress will now update the headers to drop any untrusted values, thereby making sure that WSGI apps only get trusted and validated values that Waitress itself used to update the environ. See and

3.0.1 (2024-10-28)

Backward Incompatibilities

• Python 3.8 is no longer supported. See .

Features

• Added support for Python 3.13. See .

Security

• Fix a bug that would lead to Waitress busy looping on select() on a half-open socket due to a race condition that existed when creating a new HTTPChannel. See , and

  With thanks to Dylan Jay and Dieter Maurer for their extensive debugging and helping track this down.

• No longer strip the header values before passing them to the WSGI environ. See and

• Fix a race condition in Waitress when channel_request_lookahead is enabled that could lead to HTTP request smuggling.

  See

3.0.0 (2024-02-04)

• Rename "master" git branch to "main"

• Fix a bug that would appear on macOS whereby if we accept() a socket that is already gone, setting socket options would fail and take down the server. See

• Fixed testing of vendored asyncore code to not rely on particular naming for errno's. See

• HTTP Request methods and versions are now validated to meet the HTTP standards thereby dropping invalid requests on the floor. See

• No longer close the connection when sending a HEAD request response. See

• Always attempt to send the Connection: close response header when we are going to close the connection to let the remote know in more instances.

• Python 3.7 is no longer supported. Add support for Python 3.11, 3.12 and PyPy 3.9, 3.10. See

• Document that trusted_proxy may be set to a wildcard value to trust all proxies. See

Updated Defaults

• clear_untrusted_proxy_headers is set to True by default. See