From 02184282c7b6f68f905a08670b93862662bf4397 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Thu, 5 Apr 2012 13:31:12 -0700 Subject: Clarify that the purpose of computing all the miscellaneous collection types is to register them with the appropriate ABCs. --- Lib/collections/abc.py | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/Lib/collections/abc.py b/Lib/collections/abc.py index 7fbe84d..37a813a 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 = ??? -- cgit v0.12