[docs] [issue18558] Iterable glossary entry needs clarification

Raymond Hettinger report at bugs.python.org
Sun Sep 24 15:09:49 EDT 2017

Raymond Hettinger added the comment:

I'll follow David Murray's suggestion here.  The glossary definition of iterable is already very good, it just needs to clarify that the __getitem__() method needs to implement sequence semantics.  Anything further is beyond the scope of a glossary entry.

Also, I'll amend the docs on collections.abc.Iterable() to be more specific about what it is does and doesn't recognize.

FWIW, the topic is also discussed in other places:

* https://docs.python.org/3/library/functions.html#iter
* https://docs.python.org/3/reference/datamodel.html#object.__getitem__
* https://docs.python.org/3/reference/datamodel.html#object.__iter__


Python tracker <report at bugs.python.org>

More information about the docs mailing list