Twisted - Revision history

Cblp.su: исправил мелкие огрехи; добавил про поддерживаемые протоколы

2010-07-11T20:10:02Z

исправил мелкие огрехи; добавил про поддерживаемые протоколы

164.67.235.173 at 08:44, 16 December 2009

2009-12-16T08:44:09Z

Vindicar at 10:56, 8 July 2009

2009-07-08T10:56:51Z

Feez at 14:18, 10 June 2007

2007-06-10T14:18:35Z

Feez: /* Для начинающего Twisted-разработчика */

2007-06-10T12:36:58Z

‎Для начинающего Twisted-разработчика

Feez: /* Для начинающего Twisted-разработчика */

2007-06-10T12:35:14Z

‎Для начинающего Twisted-разработчика

Feez: /* Для начинающего Twisted-разработчика */ у меня проблемы с ясностью изложения. Это вторая попытка :)

2007-06-10T12:34:26Z

‎Для начинающего Twisted-разработчика: у меня проблемы с ясностью изложения. Это вторая попытка :)

Juriks: /* Для Jabber разработчика */ +todo для сведущих

2007-06-04T20:19:30Z

‎Для Jabber разработчика: +todo для сведущих

Leksey: typo

2007-05-28T19:03:32Z

typo

Feez: /* Пример клиентского приложения */ внес в пример изменения необходимые для работы с Twisted 2.5.0

2007-05-28T18:03:14Z

‎Пример клиентского приложения: внес в пример изменения необходимые для работы с Twisted 2.5.0

@@ Line 2: / Line 2: @@
 |             name=Twisted
 <!--       Общая информация          -->
-|              url=http://twistedmatrix.com/trac/
+|              url=[http://twistedmatrix.com/ twistedmatrix.com]
 |         language={{Lang|l|Python}}
-|        xmlparser=внутренний
+|        xmlparser=внутренний (twisted.words.xish)
 <!--        Реализация стандартов   -->
 |           roster=нет
@@ Line 20: / Line 20: @@
 }}
-'''Twisted''' -- framework для написания сетевых приложений.
+'''Twisted'''&nbsp;— фрэймворк для написания сетевых приложений на [[Python]].
 Предоставляет механизмы для легкой реализации сетевого сервера и клиента.
 Есть классы облегчающие реализацию своего протокола, а также уже реализована обработка большого числа существующих протоколов, в том числе и XML-потока [[Jabber]]-а.
 Но работа Twisted не ограничивается только сетью.
 Этот фреймворк облегчает создание расширяемых с помощью плагинов программ, конструирование многосервисных программ, создание единой авторизации пользователей между сервисами и многое другое.
 == Для начинающего Twisted-разработчика ==
-В отличие от многих других [[Library|библиотек]] и фреймворков для реализации Jabber-приложений, в twisted-e обработка нескольких клиентских соединений производится не через потоки или процессы, а через конечный автомат ([http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BD%D0%B5%D1%87%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82 FSM]). Это означает, что всех клиентов обслуживает, грубо говоря, <u>один поток и один цикл</u>, а вся ответственность за "параллелизацию" работы c клиентами ложится на плечи программиста, а не ОС. Такой подход признан более эффективным, но и более сложным в исполнении.
+В отличие от многих других [[библиотека|библиотек]] и фреймворков для реализации Jabber-приложений, в Twisted обработка нескольких клиентских соединений производится не через потоки или процессы, а через {{w|конечный автомат}}. Это означает, что всех клиентов обслуживает, грубо говоря, ''один поток и один цикл'', а вся ответственность за «параллелизацию» работы c клиентами ложится на плечи программиста, а не ОС. Такой подход признан более эффективным, но и более сложным в исполнении.
-К счастью, вся сложная часть уже реализована в twisted-е, а программисту остается только создавать свои обработчики событий и придерживаться нескольких правил:
+К счастью, вся сложная часть уже реализована в Twisted, а программисту остается только создавать свои обработчики событий и придерживаться нескольких правил:
-# Функция не должна долго думать. Так как все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому "долгие" задачи (большие вычисления и т.п.) должны быть выделены в отдельный поток, который в конце работы вернет результат с помощью вызова функции в общем цикле (создание потока и возврат результата можно облегчить с помощью twisted.internet.threads.deferToThread).
+# Функция не должна долго думать. Так как все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому «долгие» задачи (большие вычисления и&nbsp;т.&nbsp;п.) должны быть выделены в отдельный поток, который в конце работы вернет результат с помощью вызова функции в общем цикле (создание потока и возврат результата можно облегчить с помощью <code>twisted.internet.threads.deferToThread</code>).
-# Вся работа с внешними и потенциально-тормознутыми данными, а это базы данных, сеть и даже работа с файлами, по тем же причинам должна быть разделена на две части (обычно через объект Deferred): первая отправляет запрос, вторая (callback) обрабатывает результат когда он появится. Для такой работы с большой частью тормознутых объектов уже подготовлены нужные классы.
+# Вся работа с внешними и потенциально-тормознутыми данными, а это базы данных, сеть и даже работа с файлами, по тем же причинам должна быть разделена на две части (обычно через объект Deferred): первая отправляет запрос, вторая (callback) обрабатывает результат, когда он появится. Для такой работы с большой частью тормознутых объектов уже подготовлены нужные классы.
-# Вся работа с сетью осуществляется в небезопасном, с точки зрения потоков, режиме. Поэтому для отправки в сеть каких-либо данных из потока (если вы все же решили выделить отдельный) необходимо воспользоваться специальными функциями, которые вставят отправку в общий цикл (reactor.callFromThread). То же самое касается и всех других вещей, которые в "многопоточной" программе требовали блокировок.
+# Вся работа с сетью осуществляется в небезопасном, с точки зрения потоков, режиме. Поэтому для отправки в сеть каких-либо данных из потока (если вы все же решили выделить отдельный) необходимо воспользоваться специальными функциями, которые вставят отправку в общий цикл (<code>reactor.callFromThread</code>). То же касается и других вещей, которые в многопоточной программе требовали блокировок.
-== Для Jabber разработчика ==
+== Для Jabber-разработчика ==
-Реализация Jabber протокола находится в пакете twisted.words.protocols.jabber.
+Реализация Jabber протокола находится в пакете <code>twisted.words.protocols.jabber</code>.
-{{Todo|про создание и отправку станз}}
+{{Todo|про создание и отправку стансов}}
 {{Todo|про создание обработчиков}}
 === Пример клиентского приложения ===
 Пример простого бота для Jabber-сервера ([http://yoan.dosimple.ch/blog/2007/01/30/ источник], адаптирован для работы с Twisted 2.5.0)
   # Эти модули понадобятся.
@@ Line 54: / Line 53: @@
   me = jid.JID("greutly@swissjabber.ch/TwistedWords")
-  # Так как бот -- это клиентское приложение, то и factory (см [http://twistedmatrix.com/projects/core/documentation/howto/glossary.html#Factory глоссарий])
+  # Так как бот -- это клиентское приложение, то и factory (см. [http://twistedmatrix.com/projects/core/documentation/howto/glossary.html#Factory глоссарий])
-  # тоже будет клиентским. Библиотека twisted.words.protocols.jabber.client
+  # тоже будет клиентским. Модуль twisted.words.protocols.jabber.client
   # предоставляет класс для создания factory Jabber-клиентов.
   factory = client.basicClientFactory(me, "password")
@@ Line 96: / Line 95: @@
   # Запуск реактора
   reactor.run()
 == Ссылки ==
 * [http://www.opennet.ru/base/dev/server_way.txt.html Подходы к организации серверного приложения]
 * [http://twistedmatrix.com/documents/current/api/ Twisted API]
-* [http://twistedmatrix.com/projects/core/documentation/howto/index.html Twisted документация]
+* [http://twistedmatrix.com/projects/core/documentation/howto/index.html Документация]
 * [http://ru.pywiki.com/index.php/Twisted Twisted на русскоязычной Python wiki]
-* [http://twistedmatrix.com/projects/core/documentation/howto/tutorial/index.html пример реализации протоколо Finger с помощью Twisted]
+* [http://twistedmatrix.com/projects/core/documentation/howto/tutorial/index.html Пример реализации] протокола {{w|Finger}} с помощью Twisted

@@ Line 81: / Line 81: @@
   # пришло.
   def gotMessage(message):
-     # sorry for the __str__(), makes unicode happy
+     # sorry for the str(), makes unicode happy
      print u"from: %s" % message["from"]
      for e in message.elements():
          if e.name == "body":
-             print unicode(e.__str__())
+             print unicode(str(e))
              break

@@ Line 3: / Line 3: @@
 <!--       Общая информация          -->
 |              url=http://twistedmatrix.com/trac/
-|         language=[[Python]]
+|         language={{Lang|l|Python}}
 |        xmlparser=внутренний
 <!--        Реализация стандартов   -->
@@ Line 18: / Line 18: @@
 |             sasl=да
 |        component=да
-}}[[Category:Python]][[Category:Python_Library]]
+}}
 '''Twisted''' -- framework для написания сетевых приложений.
@@ Line 96: / Line 96: @@
   # Запуск реактора
   reactor.run()
 == См. также ==
 * [http://www.opennet.ru/base/dev/server_way.txt.html Подходы к организации серверного приложения]
 * [http://twistedmatrix.com/documents/current/api/ Twisted API]

@@ Line 1: / Line 1: @@
 {{Library
 |             name=Twisted
 |              url=http://twistedmatrix.com/trac/
 |         language=[[Python]]
 }}[[Category:Python]][[Category:Python_Library]]

@@ Line 17: / Line 17: @@
 К счастью, вся сложная часть уже реализована в twisted-е, а программисту остается только создавать свои обработчики событий и придерживаться нескольких правил:
-# Функция не должна долго думать. Так все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому "долгие" задачи (большие вычисления и т.п.) должны быть выделены в отдельный поток, который в конце работы вернет результат с помощью вызова функции в общем цикле (создание потока и возврат результата можно облегчить с помощью twisted.internet.threads.deferToThread).
+# Функция не должна долго думать. Так как все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому "долгие" задачи (большие вычисления и т.п.) должны быть выделены в отдельный поток, который в конце работы вернет результат с помощью вызова функции в общем цикле (создание потока и возврат результата можно облегчить с помощью twisted.internet.threads.deferToThread).
 # Вся работа с внешними и потенциально-тормознутыми данными, а это базы данных, сеть и даже работа с файлами, по тем же причинам должна быть разделена на две части (обычно через объект Deferred): первая отправляет запрос, вторая (callback) обрабатывает результат когда он появится. Для такой работы с большой частью тормознутых объектов уже подготовлены нужные классы.
 # Вся работа с сетью осуществляется в небезопасном, с точки зрения потоков, режиме. Поэтому для отправки в сеть каких-либо данных из потока (если вы все же решили выделить отдельный) необходимо воспользоваться специальными функциями, которые вставят отправку в общий цикл (reactor.callFromThread). То же самое касается и всех других вещей, которые в "многопоточной" программе требовали блокировок.

@@ Line 14: / Line 14: @@
 == Для начинающего Twisted-разработчика ==
-В отличии от многих других [[Library|библиотек]] и фреймворков для реализации Jabber-приложений, в twisted-e обработка нескольких клиентских соединений производится не через потоки или процессы, а через конечный автомат ([http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BD%D0%B5%D1%87%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82 FSM]).
+В отличии от многих других [[Library|библиотек]] и фреймворков для реализации Jabber-приложений, в twisted-e обработка нескольких клиентских соединений производится не через потоки или процессы, а через конечный автомат ([http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BD%D0%B5%D1%87%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82 FSM]). Это означает, что всех клиентов обслуживает, грубо говоря, <u>один поток и один цикл</u>, а вся ответственность за "параллелизацию" работы c клиентами ложится на плечи программиста, а не ОС. Такой подход признан более эффективным, но и более сложным в исполнении.
-Это заставляет при написании приложения придерживаться нескольких правил:
-# Функция не должна долго думать. Так как практически все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому "долгие" задачи должны быть выделены в отдельный поток, который в конце работы передаст результат с помощью вызова функции в общем цикле (например с помощью twisted.internet.threads.deferToThread).
+К счастью, вся сложная часть уже реализована в twisted-е, а программисту остается только создавать свои обработчики событий и придерживаться нескольких правил:
-# Вся работа с внешними и потенциально-тормознутыми данными, это базы данных, сеть и даже работа с файлами, по тем же причинам должна быть разделена на две части (обычно через объект Deferred):
+# Функция не должна долго думать. Так все соединения обрабатываются в одном потоке и в одном цикле, то каждая пауза сказывается на всех. Поэтому "долгие" задачи (большие вычисления и т.п.) должны быть выделены в отдельный поток, который в конце работы вернет результат с помощью вызова функции в общем цикле (создание потока и возврат результата можно облегчить с помощью twisted.internet.threads.deferToThread).
-## Первая отправляет запрос
+# Вся работа с внешними и потенциально-тормознутыми данными, а это базы данных, сеть и даже работа с файлами, по тем же причинам должна быть разделена на две части (обычно через объект Deferred): первая отправляет запрос, вторая (callback) обрабатывает результат когда он появится. Для такой работы с большой частью тормознутых объектов уже подготовлены нужные классы.
-## Вторая (callback) обрабатывает результат когда он появится.
+# Вся работа с сетью осуществляется в небезопасном, с точки зрения потоков, режиме. Поэтому для отправки в сеть каких-либо данных из потока (если вы все же решили выделить отдельный) необходимо воспользоваться специальными функциями, которые вставят отправку в общий цикл (reactor.callFromThread). То же самое касается и всех других вещей, которые в "многопоточной" программе требовали блокировок.
 # Вся работа с сетью осуществляется в небезопасном, с точки зрения потоков, режиме. Поэтому для отправки в сеть каких-либо данных из потока необходимо воспользоваться специальными функциями, которые вставят отправку в общий цикл (reactor.callFromThread)
 == Для Jabber разработчика ==

@@ Line 28: / Line 28: @@
 === Пример клиентского приложения ===
-Пример простого бота для Jabber-сервера ([http://yoan.dosimple.ch/blog/2007/01/30/ источник], адоптирован для работы с Twisted 2.5.0)
+Пример простого бота для Jabber-сервера ([http://yoan.dosimple.ch/blog/2007/01/30/ источник], адаптирован для работы с Twisted 2.5.0)
@@ Line 47: / Line 47: @@
   # что-то вроде "открыть сокет, подождать ответ, послать логин/пароль,
   # подождать и т.д." тоже нельзя. Для того, чтобы выполнить какие-то
-  # определенные действия после авторизации, наеобходимо создать callback:
+  # определенные действия после авторизации, необходимо создать callback:
   def authd(xmlstream):
      # создание XML элемента presence.