[Python-checkins] cpython: asyncio: Use Interface instead of ABC. Fixes issue 19726.

[guido.van.rossum]

http://hg.python.org/cpython/rev/5469e1a68dbd
changeset:   87664:5469e1a68dbd
user:        Guido van Rossum <guido at python.org>
date:        Sat Nov 30 15:35:42 2013 -0800
summary:
  asyncio: Use Interface instead of ABC.  Fixes issue 19726.

files:
  Lib/asyncio/events.py     |   4 ++--
  Lib/asyncio/protocols.py  |   8 ++++----
  Lib/asyncio/transports.py |  10 +++++-----
  3 files changed, 11 insertions(+), 11 deletions(-)


diff --git a/Lib/asyncio/events.py b/Lib/asyncio/events.py
--- a/Lib/asyncio/events.py
+++ b/Lib/asyncio/events.py
@@ -234,7 +234,7 @@
         protocol_factory should instantiate object with Protocol interface.
         pipe is file-like object already switched to nonblocking.
         Return pair (transport, protocol), where transport support
-        ReadTransport ABC"""
+        ReadTransport interface."""
         # The reason to accept file-like object instead of just file descriptor
         # is: we need to own pipe and close it at transport finishing
         # Can got complicated errors if pass f.fileno(),
@@ -247,7 +247,7 @@
         protocol_factory should instantiate object with BaseProtocol interface.
         Pipe is file-like object already switched to nonblocking.
         Return pair (transport, protocol), where transport support
-        WriteTransport ABC"""
+        WriteTransport interface."""
         # The reason to accept file-like object instead of just file descriptor
         # is: we need to own pipe and close it at transport finishing
         # Can got complicated errors if pass f.fileno(),
diff --git a/Lib/asyncio/protocols.py b/Lib/asyncio/protocols.py
--- a/Lib/asyncio/protocols.py
+++ b/Lib/asyncio/protocols.py
@@ -4,7 +4,7 @@
 
 
 class BaseProtocol:
-    """ABC for base protocol class.
+    """Common base class for protocol interfaces.
 
     Usually user implements protocols that derived from BaseProtocol
     like Protocol or ProcessProtocol.
@@ -59,7 +59,7 @@
 
 
 class Protocol(BaseProtocol):
-    """ABC representing a protocol.
+    """Interface for stream protocol.
 
     The user should implement this interface.  They can inherit from
     this class but don't need to.  The implementations here do
@@ -95,7 +95,7 @@
 
 
 class DatagramProtocol(BaseProtocol):
-    """ABC representing a datagram protocol."""
+    """Interface for datagram protocol."""
 
     def datagram_received(self, data, addr):
         """Called when some datagram is received."""
@@ -108,7 +108,7 @@
 
 
 class SubprocessProtocol(BaseProtocol):
-    """ABC representing a protocol for subprocess calls."""
+    """Interface for protocol for subprocess calls."""
 
     def pipe_data_received(self, fd, data):
         """Called when the subprocess writes data into stdout/stderr pipe.
diff --git a/Lib/asyncio/transports.py b/Lib/asyncio/transports.py
--- a/Lib/asyncio/transports.py
+++ b/Lib/asyncio/transports.py
@@ -4,7 +4,7 @@
 
 
 class BaseTransport:
-    """Base ABC for transports."""
+    """Base class for transports."""
 
     def __init__(self, extra=None):
         if extra is None:
@@ -27,7 +27,7 @@
 
 
 class ReadTransport(BaseTransport):
-    """ABC for read-only transports."""
+    """Interface for read-only transports."""
 
     def pause_reading(self):
         """Pause the receiving end.
@@ -47,7 +47,7 @@
 
 
 class WriteTransport(BaseTransport):
-    """ABC for write-only transports."""
+    """Interface for write-only transports."""
 
     def set_write_buffer_limits(self, high=None, low=None):
         """Set the high- and low-water limits for write flow control.
@@ -115,7 +115,7 @@
 
 
 class Transport(ReadTransport, WriteTransport):
-    """ABC representing a bidirectional transport.
+    """Interface representing a bidirectional transport.
 
     There may be several implementations, but typically, the user does
     not implement new transports; rather, the platform provides some
@@ -137,7 +137,7 @@
 
 
 class DatagramTransport(BaseTransport):
-    """ABC for datagram (UDP) transports."""
+    """Interface for datagram (UDP) transports."""
 
     def sendto(self, data, addr=None):
         """Send data to the transport.

-- 
Repository URL: http://hg.python.org/cpython