https://github.com/python/cpython/commit/a81d9509ee60c405e08012aec5d97da5840b590b
commit: a81d9509ee60c405e08012aec5d97da5840b590b
branch: main
author: Raymond Hettinger <[email protected]>
committer: rhettinger <[email protected]>
date: 2024-02-29T11:30:18-06:00
summary:
Make the iter_except() recipe more compact. (gh-116132)
Only one example is needed
files:
M Doc/library/itertools.rst
diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index c26f6c89b4920a..072fe024227ad2 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -983,28 +983,10 @@ which incur interpreter overhead.
""" Call a function repeatedly until an exception is raised.
Converts a call-until-exception interface to an iterator interface.
- Like builtins.iter(func, sentinel) but uses an exception instead
- of a sentinel to end the loop.
-
- Priority queue iterator:
- iter_except(functools.partial(heappop, h), IndexError)
-
- Non-blocking dictionary iterator:
- iter_except(d.popitem, KeyError)
-
- Non-blocking deque iterator:
- iter_except(d.popleft, IndexError)
-
- Non-blocking iterator over a producer Queue:
- iter_except(q.get_nowait, Queue.Empty)
-
- Non-blocking set iterator:
- iter_except(s.pop, KeyError)
-
"""
+ # iter_except(d.popitem, KeyError) --> non-blocking dictionary iterator
try:
if first is not None:
- # For database APIs needing an initial call to db.first()
yield first()
while True:
yield func()
@@ -1012,7 +994,6 @@ which incur interpreter overhead.
pass
-
The following recipes have a more mathematical flavor:
.. testcode::
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
