http —- HTTP 模块

源代码: Lib/http/init.py [https://github.com/python/cpython/tree/3.13/Lib/http/__init__.py]

http 是一个包，它收集了多个用于处理超文本传输协议的模块:

• http.client 是一个底层的 HTTP 协议客户端；对于高层级的 URL 访问请使用 urllib.request

• http.server 包含基于 socketserver 的基本 HTTP 服务类

• http.cookies 包含一些有用来实现通过 cookies 进行状态管理的工具

• http.cookiejar 提供了 cookies 的持久化

http 模块还定义了下列枚举来帮助你使用 http 相关的代码:

• class http.HTTPStatus

Added in version 3.5.

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 状态码

已支持的，IANA 注册的状态码 [https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml] 在 http.HTTPStatus 中可用的有:

为了保持向后兼容性，枚举值也以常量形式出现在 http.client 模块中，。 枚举名等于常量名 (例如 http.HTTPStatus.OK 也可以是 http.client.OK)。

在 3.7 版本发生变更: 添加了 421 MISDIRECTED_REQUEST 状态码。

Added in version 3.8: 添加了 451 UNAVAILABLE_FOR_LEGAL_REASONS 状态码。

Added in version 3.9: 增加了 103 EARLY_HINTS, 418 IM_A_TEAPOT 和 425 TOO_EARLY 状态码

在 3.13 版本发生变更: 实现了针对状态常量的 RFC9110 命名。 旧常量名被保留用于向下兼容。

HTTP 状态类别

Added in version 3.12.

这些枚举值具有一些用于指明 HTTP 状态类别的特征属性:

用法：

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

• class http.HTTPMethod

Added in version 3.11.

一个 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 方法

已支持的，IANA 注册的方法 [https://www.iana.org/assignments/http-methods/http-methods.xhtml] 在 http.HTTPMethod 中可用的有: