Есть ли исчерпывающая и обширная документация по Twisted, которая лучше официального сайта? - PullRequest
14 голосов
/ 04 июня 2010

Я давно смотрю на витую. Это выглядит интересно - это хороший способ использовать большую мощность при написании серверов. К сожалению, несмотря на написание нескольких веб-серверов с использованием twisted.web (из чтения чужого источника и чрезвычайно устаревшей книги О'Рейли), я никогда не чувствовал, что достиг сходства с витой ... уровень понимания что на самом деле дало мне часть силы, которая, кажется, имеет.

Я думаю, что мне нужна хорошая документация, чтобы достичь лучшего уровня понимания - у меня просто нет времени разбираться в источнике, а другие потоки в SO упоминали официальную документацию twisted , которая в лучшем случае пятнистый, в худшем отсутствует, а иногда очень устарел.

Есть ли что-нибудь еще, что является более тщательным, более щадящим и более полезным, или я застрял с другими классическими, скучными STFU и RTFM, даже если TFM не помогает?


Обновление

В ответ на комментарий JP Calderone о том, что у меня просто есть сука, в некоторой степени, я полагаю, что да, но я думаю, что широта вопроса верна, учитывая широту и ценность Twisted и отсутствие очевидного, тщательного документация. У меня есть несколько вещей, которые я хотел бы исследовать, но я получал хорошие результаты, просто взламывая вещи вместе и спрашивая конкретику, когда более глубокое и широкое понимание того, что я ищу, на мой взгляд, бесполезно .

Контраст, который сразу приходит на ум, - это Django ... Я могу прочитать (очень тщательную) документацию по Django и не обязательно знать, как сделать все, что он может сделать немедленно, но я могу получить действительно хороший обзор как Я мог бы сделать все, что мне было нужно, и точно знать, где искать, когда придет время.

Ответы [ 5 ]

15 голосов
/ 05 июня 2010

Я собираюсь повторить то, что сказали некоторые из ответивших здесь (все они хорошие ответы) в надежде дать ответ, который является несколько всеобъемлющим.

  1. Хотя включенная документация местами местами, базовая документация содержит несколько полезных и кратких введений в основные концепции Twisted. В частности, см. Использование отложенных , клиентов записи и серверов записи .
  2. Кроме того, документация API - особенно документация в интерфейсных модулях - становится все более тщательной и согласованной с каждым последующим выпуском.
  3. Если вас интересует описание целей и дизайна Twisted на более высоком уровне, чтобы вы знали, как обратиться к этой другой документации, Я стал соавтором статьи, представленной на USENIX 2003 с Итамар Тернер-Трейринг .
  4. FAQ по Twisted также немного извилист, но может помочь вам с множеством камней преткновения, с которыми люди сталкиваются, пробираясь через вводный материал.
  5. В книге О'Рейли о Twisted есть несколько замечательных примеров, которые могут дополнительно разъяснить основные понятия, такие как Отложенные и Реактор.
  6. Учебные пособия Жана-Пола Кальдероне "Twisted Web In 60 Seconds" , конечно, являются хорошим введением в несколько более высокий уровень twisted.web, но вы также увидите множество полезных шаблонов, повторяющихся в течение которых может пригодиться вам в любом приложении, которое вы пишете.
  7. Я написал пару статей о строительных блоках, используемых в Twisted, для работы с файловой системой и для загрузки плагинов .
  8. Последнее, но определенно не в последнюю очередь, Скромно озаглавленное «Twisted Intro» Дейва Петиколаса - это очень подробное описание, со схемами и анекдотами, на вводном материале, с которым у многих людей возникают трудности. с.

Обратите также внимание, что все новые функциональные возможности поставляются с новой документацией API (т.е. справочной); мы надеемся, что для людей с техническими навыками письма будет более разумно писать документацию, не пытаясь даже понять, что означают названия методов.

7 голосов
/ 04 июня 2010

Twisted Intro от Дейва Петиколаса - это потрясающий обзор Twisted с нуля. Все начинается просто, а затем начинает становиться все глубже и глубже, объясняя все на этом пути.

Я годами использовал Twisted и нашел это вступление, чтобы заполнить все те пробелы, которые мне не хватало, и пролить свет на все это. Определенно стоит потратить время, чтобы проверить это!

2 голосов
/ 04 июня 2010

Проверка Витая паутина за 60 секунд . Жан-Поль Кальдероне!

Но, честно говоря, официальная документация Twisted не идеальна, но я не буду называть это отвратительным. В нем много ценной информации.

2 голосов
/ 04 июня 2010

Посмотрите на этот предыдущий пост ...

Python Twisted: с чего начать

1 голос
/ 04 июня 2010

Это книга О'Рейли Основы программирования витой сети .

Я не читал его, но ToC выглядит достаточно хорошо.

...