Модуль HTTP в Python

HTTP-методы и HTTP-коды ответа в Python

Модуль http - это пакет, собирающий несколько модулей для работы с протоколом передачи гипертекста:

• http.client - низкоуровневый клиент протокола HTTP. Клиент высокого уровня urllib.request
• http.server - содержит базовые классы HTTP-серверов на основе socketserver
• http.cookies - имеет утилиты для реализации управления состоянием с помощью cookies
• http.cookiejar - обеспечивает сохраняемость cookies

Модуль http также определяет следующие перечисления, которые помогают работать с кодом, связанным с HTTP протоколом:

http.HTTPStatus:

Класс http.HTTPStatus представляет собой подкласс enum.IntEnum, который определяет набор кодов состояния HTTP, причин и длинных описаний на английском языке.

Пример использования:

>>> 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, доступных в http.HttpStatus

Поддерживаемые коды состояния, зарегистрированные в IANA, доступны в http.HttpStatus:

Для сохранения обратной совместимости значения enum также присутствуют в модуле http.client в виде констант. Имя enum равно имени константы (т.е. http.HttpStatus.OK также доступен как http.client.OK).

Категории состояния HTTP

Значения enum имеют несколько свойств для указания категории состояния HTTP:

Использование:

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

http.HTTPMethod:

Класс http.HTTPMethod представляет собой подкласс enum.StrEnum, который определяет набор HTTP-методов и описаний на английском языке.

Использование:

>>> 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-методов доступных в классе http.HttpMethod

Список поддерживаемых, зарегистрированных IANA методов, доступных в http.HttpMethod: