python - 有没有比官方网站更好的 Twisted 的全面、广泛的文档？

Question

我看了 twisted 有一段时间了。它看起来很有趣——这似乎是一种在编写服务器时利用大量功能的好方法。不幸的是，尽管使用 twisted.web 编写了一些 web 服务器(来自阅读其他人的源代码和一本非常过时的 O'Reilly 书)，但我从未真正觉得我已经与 twisted 产生了亲和性......一种理解水平这实际上给了我一些看起来它拥有的力量。

我想我需要一些好的文档来达到更好的理解水平——我根本没有时间仔细研究源代码，SO 上的其他线程已经提到了 twisted's official documentation ，充其量是零散的，最坏的情况是不存在，并且偶尔会非常过时。

有没有其他更彻底、更宽容、更有用的东西，或者我是否坚持使用另一个经典的、无聊的 STFU 和 RTFM，即使 TFM 没有帮助？

---

更新

为了回应 JP Calderone 的评论，我只是有一个婊子，在某种程度上我想我是，但我认为考虑到 Twisted 的广度和值(value)以及缺乏明显、彻底的问题，这个问题的广度是有效的文档。我脑子里有一些我想调查的事情，但我一直得到不错的结果，只是把事情混在一起并询问具体情况，而我正在寻找更深入、更广泛的理解，在我看来，这没有帮助.

立即想到的对比是 Django...我可以阅读(非常详尽的)Django 文档，不一定知道如何立即完成它可以做的所有事情，但我可以很好地了解 如何我可以做所有我需要做的事情，并且确切地知道在时机成熟时去哪里找。

Answer 1

我将重复这里的一些回答者所说的内容(他们都是很好的答案)，希望提供一个比较全面的答案。

1. 虽然包含的文档在某些地方参差不齐，the core documentation包含对 Twisted 中基本概念的几个有用且简短的介绍。特别是，参见 Using Deferreds , Writing Clients和 Writing Servers .
2. 此外，API documentation - 特别是 interface modules 中的文档- 越来越全面，并且与每个后续版本保持一致。
3. 如果您对 Twisted 的目标和设计的更高层次的描述感兴趣，那么您知道如何处理其他一些文档，I co-authored a paper presented at USENIX 2003与 Itamar Turner-Trauring .
4. Twisted's FAQ也有点曲折，但可能会帮助您解决人们在学习介绍性 Material 时遇到的许多绊脚石。
5. O'Reilly book about Twisted有一些很好的例子，可以进一步阐明核心概念，如 Deferreds 和 Reactor。
6. Jean-Paul Calderone's "Twisted Web In 60 Seconds" tutorials当然，是对更高级别的 twisted.web 的一个很好的介绍，但您还会看到许多有用的模式在整个过程中重复出现，这些模式可能对您正在编写的任何应用程序都有用。
7. 我已经写了两篇关于 Twisted 中使用的构建 block 的文章，到 deal with the filesystem和load plugins .
8. 最后但当然 并非最不重要的，Dave Peticolas's modestly titled "Twisted Intro"是对许多人难以理解的介绍性 Material 的非常全面的描述，包括图表和轶事。

另请注意，所有新功能都附带新的 API(即引用)文档；我们希望这将使具有技术写作技能的人更合理地编写文档，而不必费力去理解方法名称的含义。