From 44571daf0e3a1df376dc97551643281bdf2dbcb8 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sun, 5 May 2013 19:53:41 -0700 Subject: [PATCH] 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. --- Doc/library/itertools.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index 1eb554a40ae..7099fa031b9 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -705,9 +705,9 @@ which incur interpreter overhead. next(b, None) return zip(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 zip_longest(*args, fillvalue=fillvalue)