http — HTTP modules (original) (raw)

Source code: Lib/http/__init__.py

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

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

The http module also defines the following enums that help you work with http related code:

class http.HTTPStatus¶

Added in version 3.5.

A subclass of 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 HTTPStatus.OK == 200 True HTTPStatus.OK.value 200 HTTPStatus.OK.phrase 'OK' HTTPStatus.OK.description 'Request fulfilled, document follows' list(HTTPStatus) [HTTPStatus.CONTINUE, HTTPStatus.SWITCHING_PROTOCOLS, ...]

HTTP status codes¶

Supported,IANA-registered status codesavailable in http.HTTPStatus are:

In order to preserve backwards compatibility, enum values are also present in the http.client module in the form of constants. The enum name is equal to the constant name (i.e. http.HTTPStatus.OK is also available ashttp.client.OK).

Changed in version 3.7: Added 421 MISDIRECTED_REQUEST status code.

Added in version 3.8: Added 451 UNAVAILABLE_FOR_LEGAL_REASONS status code.

Added in version 3.9: Added 103 EARLY_HINTS, 418 IM_A_TEAPOT and 425 TOO_EARLY status codes.

Changed in version 3.13: Implemented RFC9110 naming for status constants. Old constant names are preserved for backwards compatibility.

HTTP status category¶

Added in version 3.12.

The enum values have several properties to indicate the HTTP status category:

Usage:

from http import HTTPStatus HTTPStatus.OK.is_success True HTTPStatus.OK.is_client_error False

class http.HTTPMethod¶

Added in version 3.11.

A subclass of enum.StrEnum that defines a set of HTTP methods and descriptions written in English.

Usage:

from http import HTTPMethod

HTTPMethod.GET <HTTPMethod.GET> HTTPMethod.GET == 'GET' True HTTPMethod.GET.value 'GET' HTTPMethod.GET.description 'Retrieve the target.' list(HTTPMethod) [<HTTPMethod.CONNECT>, <HTTPMethod.DELETE>, <HTTPMethod.GET>, <HTTPMethod.HEAD>, <HTTPMethod.OPTIONS>, <HTTPMethod.PATCH>, <HTTPMethod.POST>, <HTTPMethod.PUT>, <HTTPMethod.TRACE>]

HTTP methods¶

Supported,IANA-registered methodsavailable in http.HTTPMethod are: