On Dec 12, 2019, at 10:34, Brett Cannon <br...@python.org> wrote: > > I'm also sure the docs will say "Returns the first item yielded by the > iterable." That last word is a dead give-away on how the choice will be made > on any collection, Sequence or not. 😉 (Doubly true if this goes into > itertools.)
The docs for more_itertools.first say it’s equivalent to next of iter, which makes the behavior even more obvious to anyone who understands iteration in Python, even if they’ve never used itertools before. _______________________________________________ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-ideas-le...@python.org https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://mail.python.org/archives/list/python-ideas@python.org/message/CGMWPLJME4ZZNGHDY4DGCSF347VBMAKZ/ Code of Conduct: http://python.org/psf/codeofconduct/