[issue1736190] asyncore/asynchat patches

Doc/library/asyncore.rst

 
 :mod:`asyncore` --- Asynchronous socket handler
 ===============================================
 
 .. module:: asyncore
    :synopsis: A base class for developing asynchronous socket handling
               services.
 .. moduleauthor:: Sam Rushing <rushing@nightmare.com>
 .. sectionauthor:: Christopher Petrilli <petrilli@amber.org>
 .. sectionauthor:: Steve Holden <sholden@holdenweb.com>
@@ skipping 204 matching lines @@
       end of the connection.
 
 
    .. method:: close()
 
       Close the socket.  All future operations on the socket object will fail.
       The remote end-point will receive no more data (after queued data is
       flushed).  Sockets are automatically closed when they are
       garbage-collected.
 
+.. class:: file_dispatcher()
+  A file_dispatcher takes a file descriptor or file object along with an optional

[GvR, 2008/05/05 22:02:22]

Mind keeping the line length under 80 chars?

[josiah.carlson, 2008/05/21 19:09:43]

On 2008/05/05 22:02:22, GvR wrote:
> Mind keeping the line length under 80 chars?

No problem.  Any other comments?

+  map argument and wraps it for use with the :cfunc:`poll`\ or :cfunc:`loop`\
+  functions.  If provided a file object or anything with a :cfunc:`fileno`\
+  method, that method will be called and passed to the :class:`file_wrapper`
+  constructor.
+  Availability: UNIX
+
+.. class::file_wrapper()
+  A file_wrapper takes an integer file descriptor and calls os.dup() to duplicate
+  the handle so that the original handle may be closed independently of the
+  file_wrapper.  This class implements sufficient methods to emulate a socket for
+  use by the file_dispatcher class.
+  Availability: UNIX
 
 .. _asyncore-example:
 
 asyncore Example basic HTTP client
 ----------------------------------
 
 Here is a very basic HTTP client that uses the :class:`dispatcher` class to
 implement its socket handling::
 
    import asyncore, socket
@@ skipping 18 matching lines @@
        def writable(self):
            return (len(self.buffer) > 0)
 
        def handle_write(self):
            sent = self.send(self.buffer)
            self.buffer = self.buffer[sent:]
 
    c = http_client('www.python.org', '/')
 
    asyncore.loop()