Есть ли какая-нибудь полная и обширная документация по Twisted, которая лучше, чем официальный сайт?

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

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

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


Обновить

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

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


person Shabbyrobe    schedule 04.06.2010    source источник
comment
Если бы вы более конкретно указали, что хотите понять, кто-нибудь мог бы порекомендовать вам какую-нибудь документацию, которая могла бы дать вам это понимание. Просто сказать, что вы хотите понять Twisted, означает, что лучший доступный ответ — прочитать документацию Twisted. Очевидно, вам нужно что-то конкретное, но вы не сказали, что именно. Таким образом, этот вопрос воспринимается как повод пожаловаться на документацию Twisted, а не как полезный или интересный вопрос. Можете ли вы отредактировать его, чтобы спросить что-то более значимое и на которое можно ответить?   -  person Jean-Paul Calderone    schedule 04.06.2010
comment
Ничего себе, я не ожидал услышать от одного из основных участников проекта! Да, я думаю, что у меня есть что-то вроде вентиля, но я думаю, что вопрос все еще актуален. Twisted кажется довольно крутым, и он был очень полезен для меня, но документация — это огромная дыра в очень достойном проекте. Есть ли какой-нибудь план привести документацию в форму (особенно теперь, когда с вебом и веб2 разобрались навсегда)? Я бы помог, но я все еще (очевидно) новичок в этом. Кроме того, нет приемлемого ответа, если это действительно так.   -  person Shabbyrobe    schedule 05.06.2010


Ответы (5)


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

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

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

person Glyph    schedule 05.06.2010

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

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

person jathanism    schedule 04.06.2010

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

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

person Etienne    schedule 04.06.2010
comment
Да, честный полицейский. Это было напрасно подстрекательским. Я поменял, но не сильно. Местами плохо. - person Shabbyrobe; 05.06.2010

Взгляните на этот предыдущий пост...

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

person Ben Hughes    schedule 04.06.2010

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

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

person codeape    schedule 04.06.2010