:mod:`http` --- HTTP modules

.. module:: http
 :synopsis: HTTP status codes and messages

Source code: :source:`Lib/http/__init__.py`

.. index::
 pair: HTTP; protocol
 single: HTTP; http (standard module)

:mod:`http` is a package that collects several modules for working with the HyperText Transfer Protocol:

• :mod:`http.client` is a low-level HTTP protocol client; for high-level URL opening use :mod:`urllib.request`
• :mod:`http.server` contains basic HTTP server classes based on :mod:`socketserver`
• :mod:`http.cookies` has utilities for implementing state management with cookies
• :mod:`http.cookiejar` provides persistence of cookies

:mod:`http` is also a module that defines a number of HTTP status codes and associated messages through the :class:`http.HTTPStatus` enum:

.. versionadded:: 3.5

A subclass of :class:`enum.IntEnum` that defines a set of HTTP status codes, reason phrases and long descriptions written in English.

Usage:

>>> from http import HTTPStatus
>>> HTTPStatus.OK
<HTTPStatus.OK: 200>
>>> HTTPStatus.OK == 200
True
>>> HTTPStatus.OK.value
200
>>> HTTPStatus.OK.phrase
'OK'
>>> HTTPStatus.OK.description
'Request fulfilled, document follows'
>>> list(HTTPStatus)
[<HTTPStatus.CONTINUE: 100>, <HTTPStatus.SWITCHING_PROTOCOLS: 101>, ...]

HTTP status codes

Supported, :class:`http.HTTPStatus` are:

.. versionchanged:: 3.7
 Added ``421 MISDIRECTED_REQUEST`` status code.

.. versionadded:: 3.8
 Added ``451 UNAVAILABLE_FOR_LEGAL_REASONS`` status code.