有没有比官方网站更好的Twisted的详尽文档？

Question

我一直在看扭曲一段时间.它看起来很有趣 - 在编写服务器时,它似乎是一种利用大量功能的好方法.不幸的是,尽管使用twisted.web编写了一些Web服务器(从阅读其他人的来源和一本极其过时的O'Reilly书籍),我从未真正感觉到我已经达成了与扭曲的亲和关系......一定程度的理解这实际上给了我一些它似乎有的力量.

我认为我需要一些好的文档才能达到更好的理解水平 - 我根本没有时间对源代码进行深入研究,SO上的其他线程也提到了twisted的官方文档,这些文档最多也是补丁,最糟糕的是,偶尔也会过时.

还有其他更彻底,更宽容,更有用的东西,还是我坚持使用另一款经典,无聊的STFU和RTFM,尽管TFM没用？

---

更新

在回应JP Calderone的评论时,我只是有一个婊子,在某种程度上我猜我是,但我认为问题的广度是有效的考虑到Twisted的广度和价值以及缺乏明显,全面的文档.我有一些想要调查的事情,但是我已经得到了好的结果,只是将事情放在一起,并且当我在寻找更深入,更广泛的理解时,要求具体细节,在我看来,没有帮助.

立即弹簧想到的对比是Django的......我可以(很透彻)Django文档阅读过并不见得知道怎么做一切可以马上做的,但我可以得到一个很好的概述如何我可以做的一切我需要这样做,并确切知道时机到来的确切位置.

Answer 1

我将重复一些这里的回答者所说的话(他们都是好的答案),希望能提供一些有点全面的答案.

1. 虽然所包含的文档在某些地方是不稳定的,但核心文档包含对Twisted中基本概念的几个有用且简要的介绍.特别是,请参阅使用延迟,编写客户端和编写服务器.
2. 此外,API文档 - 尤其是接口模块中的文档- 对于每个后续版本都越来越透彻和一致.
3. 如果您对Twisted的目标和设计有更高级别的描述感兴趣,那么您就知道如何处理其他文档,我与他人共同撰写了一份在USENIX 2003上与Itamar Turner-Trauring一起发表的论文.
4. Twisted的FAQ也有点蜿蜒,但可以帮助你解决许多人在通过介绍材料工作时遇到的绊脚石.
5. 在O'Reilly出版的关于扭曲有可能进一步阐明核心概念,如Deferreds和反应堆一些很好的例子.
6. Jean-Paul Calderone的"Twisted Web In 60 Seconds"教程是对更高级别的twisted.web的一个很好的介绍,当然,你也会看到很多有用的模式在你的任何应用程序中都可能对你有用.写作.
7. 我已经写了一篇关于Twisted中使用的构建块的文章,以处理文件系统和加载插件.
8. 最后但同样重要的是,Dave Peticolas谦虚地标题为"Twisted Intro"是一个非常全面的描述,带有图表和轶事,介绍了很多人都有困难的介绍性材料.

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

Answer 2

在扭曲的介绍由大卫Peticolas是一个惊人的扭曲的从地上爬起来的概述.它开始变得简单,然后开始越来越深入,同时解释一切.

我已经使用Twisted多年了,发现这个介绍填补了我所遗漏的所有空白并揭示了整个事情.绝对值得您花时间去看看!