]> granicus.if.org Git - python/commitdiff
Mention asyncore and Twisted in the library FAQ.
authorAntoine Pitrou <solipsis@pitrou.net>
Sat, 5 Feb 2011 11:24:15 +0000 (11:24 +0000)
committerAntoine Pitrou <solipsis@pitrou.net>
Sat, 5 Feb 2011 11:24:15 +0000 (11:24 +0000)
Doc/faq/library.rst

index 06a1ae64c7f3868c57b526eb9cf33543e98df071..ee099cfbe9d933201b8406e01ebfec03eaa4eacd 100644 (file)
@@ -757,7 +757,8 @@ some sample code::
 How do I avoid blocking in the connect() method of a socket?
 ------------------------------------------------------------
 
-The select module is commonly used to help with asynchronous I/O on sockets.
+The :mod:`select` module is commonly used to help with asynchronous I/O on
+sockets.
 
 To prevent the TCP connect from blocking, you can set the socket to non-blocking
 mode.  Then when you do the ``connect()``, you will either connect immediately
@@ -771,6 +772,12 @@ just return the errno value.  To poll, you can call ``connect_ex()`` again later
 -- ``0`` or ``errno.EISCONN`` indicate that you're connected -- or you can pass this
 socket to select to check if it's writable.
 
+.. note::
+   The :mod:`asyncore` module presents a framework-like approach to the problem
+   of writing non-blocking networking code.
+   The third-party `Twisted <http://twistedmatrix.com/>`_ library is
+   a popular and feature-rich alternative.
+
 
 Databases
 =========