Есть ли какая-то тщательная обширная документация Twisted, которая лучше официального сайта?
Я смотрел на искривленное какое-то время. Это выглядит интересно - кажется, это хороший способ использовать много энергии при написании серверов. К сожалению, несмотря на то, что вы писали несколько веб-серверов с использованием twisted.web(от чтения других источников и чрезвычайно устаревшей книги O'Reilly), я никогда не чувствовал, что я достиг близости с искривленным... уровнем понимания что на самом деле дало мне некоторую силу, как кажется.
Думаю, мне нужна хорошая документация, чтобы достичь лучшего уровня понимания - у меня просто нет времени, чтобы порыться над источником, а другие потоки на SO упоминали скрученная официальная документация, которая в лучшем случае неоднородна, отсутствует в худшем случае и иногда очень устарела.
Есть ли что-нибудь еще более тщательное, более прощающее и более полезное, или я придерживаюсь другого классического, скучного STFU и RTFM, хотя TFM не помогает?
Обновление
В ответ на комментарий Дж. П. Калдерона, что я просто сука, в какой-то степени я предполагаю, что я, но я думаю, что ширина вопроса верна, учитывая широту и ценность Twisted и отсутствие очевидных, тщательных документация. У меня есть несколько вещей в виду, что я хотел исследовать, но я получал хорошие результаты, просто взламывая вещи вместе и спрашивая специфику, когда более глубокое, более широкое понимание - это то, что я ищу, на мой взгляд, не полезно.
Контраст, который сразу приходит в голову, - это Django... Я могу прочитать (очень тщательную) документацию Django и не обязательно знать, как делать все, что он может сделать немедленно, но я могу получить действительно хороший обзор того, как я может делать все, что мне нужно, и точно знать, где искать, когда придет время.
Ответы
Ответ 1
Я собираюсь повторить то, что сказали некоторые из ответчиков (все они хорошие ответы) в надежде дать ответ, который является довольно полным.
- В то время как включенная документация является пятнистой в местах, основная документация содержит несколько полезных и кратких представлений об основных понятиях в Twisted. В частности, см. Использование отложенных ответов, Написание клиентов и Написание серверов.
- Кроме того, документация API - особенно документация в интерфейсные модули - становится все более тщательным и последовательным с каждым последующим выпуском.
- Если вас интересует более высокое описание Twisted целей и дизайна, чтобы вы знали, как подходить к какой-либо другой документации, Я соавтор документ, представленный в USENIX 2003 с Itamar Turner-Trauring.
- Twisted FAQ также немного извивается, но может помочь вам с множеством камней преткновения, с которыми люди сталкиваются при прохождении через вводный материал.
- В книге O'Reilly о Twisted есть несколько отличных примеров, которые могут еще более осветить основные понятия, такие как "Отсрочки" и "Реактор".
- Жан-Поль Кальдероне "Twisted Web In 60 Seconds" tutorials - хорошее введение в несколько более высокий уровень twisted.web, конечно, но вы также увидите много полезных шаблонов, повторяющихся в течение всего, что может быть полезно для вас в любом приложении, которое вы пишете.
- Я написал пару статей по строительным блокам, используемым в Twisted, для иметь дело с файловой системой и загрузить плагины.
- Наконец, но не в последнюю очередь, Дэйв Петиколас скромно назвал "Twisted Intro" - очень подробное описание, с диаграммами и анекдотами, на вводном материал, с которым так много людей сталкиваются с трудностями.
Также обратите внимание, что все новые функции поставляются с новой документацией API (т.е. ссылкой); мы надеемся, что это станет более разумным для людей с техническими навыками письма, чтобы писать документы, не пытаясь понять, что означают названия методов.
Ответ 2
Twisted Intro от Дейв Петиколас удивительный обзор Twisted с нуля. Он начинается просто, а затем начинает становиться все глубже и глубже, объясняя все на этом пути.
Я использую Twisted в течение многих лет и нашел это введение, чтобы заполнить все те пробелы, которые я отсутствовал, и пролил свет на все это. Определенно стоит того, чтобы проверить это!
Ответ 3
Отметьте Twisted Web за 60 секунд от Jean-Paul Calderone!
Но, честно говоря, официальная документация Twisted не идеальна, но я не буду называть ее отвратительной. Там много ценных сведений.
Ответ 4
Взгляните на этот предыдущий пост...
Python twisted: с чего начать
Ответ 5
Там книга O'Reilly Основы витой поддержки сети.
Я не читал его, но ToC выглядит неплохо.