From: Raymond Hettinger <python@rcn.com>
Date: Thu, 5 Apr 2012 20:31:12 +0000 (-0700)
Subject: Clarify that the purpose of computing all the miscellaneous collection types is to... 
X-Git-Tag: v3.3.0a3~298
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=02184282c7b6f68f905a08670b93862662bf4397;p=python

Clarify that the purpose of computing all the miscellaneous collection types is to register them with the appropriate ABCs.
---

diff --git a/Lib/collections/abc.py b/Lib/collections/abc.py
index 7fbe84dfe9..37a813abda 100644
--- a/Lib/collections/abc.py
+++ b/Lib/collections/abc.py
@@ -18,9 +18,13 @@ __all__ = ["Hashable", "Iterable", "Iterator",
            "ByteString",
            ]
 
-
-### collection related types which are not exposed through builtin ###
-## iterators ##
+# Private list of types that we want to register with the various ABCs
+# so that they will pass tests like:
+#       it = iter(somebytearray)
+#       assert isinstance(it, Iterable)
+# Note:  in other implementations, these types many not be distinct
+# and they make have their own implementation specific types that
+# are not included on this list.
 bytes_iterator = type(iter(b''))
 bytearray_iterator = type(iter(bytearray()))
 #callable_iterator = ???