h11 0.14.0

常见问题解答

为什么是它？

我想在Curio和Trio中玩HTTP，那时它们还没有任何HTTP库。所以我心想，这没什么大不了的，Python有十几种HTTP实现，肯定能找到一个可重用的。我没有找到，但我找到了Cory的号召性博文。所以我想，好吧，如果不得不从头实现HTTP，至少可以确保其他人再也不用这样做了。

我应该使用它吗？

也许吧。你应该知道，它是一个非常年轻的项目。但，它已经完成了所有功能，并有一个详尽的测试套件和完整的文档，所以下一步就是让人们尝试使用它并看看效果如何 :-)。如果你使用它，请告诉我们——至少在我们做出任何不兼容的更改之前，我们还想和你交谈！

功能/限制是什么？

大致来说，它试图实现HTTP/1.1规范第一“章节”的健壮、完整和非侵入式实现：[RFC 7230: HTTP/1.1 Message Syntax and Routing](https://tools.ietf.org/html/rfc7230)。也就是说，它主要关注在传输层上对HTTP进行实现，以及与之相关的头部信息，并努力符合规范。它不了解高级问题，如URL路由、条件GET、跨源cookie策略或内容协商。但它知道如何处理帧、处理keep-alive的跨版本差异以及“废弃的行折叠”规则，这样你就可以专注于应用程序的困难/有趣部分，并尝试支持完整的规范，即任何有用的HTTP/1.1兼容应用程序都应能够使用h11。

它是纯Python编写，且没有依赖任何标准库以外的库。

它有一个测试套件，对语句和分支的覆盖率均为100.0%。

当前它支持Python 3（在3.7-3.10版本上进行了测试）和PyPy 3。最后一个与Python 2兼容的版本是h11 0.11.x。（最初它有一个用于http-parser的Cython包装器，并使用yield from实现了一个漂亮的嵌套状态机来后处理输出。但我不得不去掉这些 - 新的解析器比旧的解析器包装器少用几行代码，是用纯Python编写的，不使用任何特殊的语言语法，并且具有更多功能。这真的很遗憾；那个旧的状态机真的很漂亮。我只需要在这里写几句话来表达我的哀悼。）

我不知道它有多快。我还没有对其进行基准测试或性能分析，所以它可能有一些无意义的热点，我一直在试图在简单性和健壮性上犯错误，而不是微优化。但在架构层面，我努力避免做出基本错误的决策，例如，我相信即使在像slowloris这样的病态输入面前，所有的解析算法仍然保持线性时间，并且没有按字节逐字节循环。（我也相信它能够面对任意/病态输入时保持有限的内存使用。）

整个库大约有800行代码。你可以在不到一个小时的时间内阅读并理解它。到目前为止，大部分精力都花在通过最小化特殊情况和临时状态操作来使事物保持简单；尽管现在它相当小且简单，我仍然很烦恼没有找到让它更小更简单的方法。（不幸的是，HTTP并不适合简单化。）

API功能基本齐全，我不期望总体轮廓有太大变化，但你不能在没有实际文档化和使用API的情况下判断API的人体工程学，所以我预计细节会有一些变化。

我该如何尝试它？

$ pip install h11
$ git clone git@github.com:python-hyper/h11
$ cd h11/examples
$ python basic-client.py

然后继续。

许可证？

MIT

行为准则？

请所有贡献者遵守我们在所有项目空间中的行为准则。