赫曼

赫曼是用于 http-status-codes2 的 CLI，http-status-codes2 是一个包含 HTTP 错误 代码注册表 的库。

该库还包含了一些任意选择、被提出或被广泛使用的错误代码的非官方代码注册表。此非官方注册表可以可选地包含在查询中。

名称

名称 赫曼 来自 HTTP Error Manual。

安装

cargo install heman

命令行界面 (CLI)

使用 heman help 获取 CLI 使用说明。

示例

查找代码 401 的含义

$ heman code 401
401 Unauthorized

查找重定向的错误代码

$ heman search redirect
307 Temporary Redirect
308 Permanent Redirect

非官方代码注册表

要包括非官方错误代码注册表在搜索查询中，请传递 --unofficial 标志

$ heman --unofficial search pot
418 I'm a teapot

参考，链接

要查看 HTTP 错误的参考，请使用 --reference 标志。要查看该参考的链接，请使用 --link

$ heman --reference code 403
403 Forbidden, [RFC9110, Section 15.5.4]

$ heman --link search timeout
408 Request Timeout, https://www.rfc-editor.org/rfc/rfc9110.html#section-15.5.9
504 Gateway Timeout, https://www.rfc-editor.org/rfc/rfc9110.html#section-15.6.5

$ heman -rl code 300
300 Multiple Choices, [RFC9110, Section 15.4.1], https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4.1

环境变量

您可以通过设置环境变量来代替 CLI 标志

$ HEMAN_INCLUDE_UNOFFICIAL_REGISTRY=1
$ HEMAN_OUTPUT_REFERENCE=1
$ heman search pot
418 I'm a teapot, [RFC2324, Section 2.3.2]

注意

赫曼 CLI 只会检查这些环境变量中是否有一个被设置。值无关紧要。

致谢

• IANA 的 超文本传输协议 (HTTP) 状态代码注册表
• Evert Pot 的 关于 HTTP 状态代码的系列文章