Issue 17862: Improve the signature of itertools grouper() recipe.
Putting *n* after the *iterable* matches the signature of other itertools
and recipes. Also, it reads better.
Suggested by Ezio Melotti.
diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index 0e98c1e..7645281 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -732,9 +732,9 @@
next(b, None)
return izip(a, b)
- def grouper(n, iterable, fillvalue=None):
+ def grouper(iterable, n, fillvalue=None):
"Collect data into fixed-length chunks or blocks"
- # grouper(3, 'ABCDEFG', 'x') --> ABC DEF Gxx
+ # grouper('ABCDEFG', 3, 'x') --> ABC DEF Gxx
args = [iter(iterable)] * n
return izip_longest(fillvalue=fillvalue, *args)