From: Ramil Nugmanov <nougmanoff@protonmail.com>
Date: Thu, 28 May 2020 16:46:22 +0000 (+0300)
Subject: bpo-40806: Clarify that itertools.product immediately consumes its inpt (GH-20492)
X-Git-Tag: v3.10.0a1~778
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cfc6ce4d40f2f01314b7e283fb972a7bb3ed3faa;p=thirdparty%2FPython%2Fcpython.git

bpo-40806: Clarify that itertools.product immediately consumes its inpt (GH-20492)
---

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index 3e5a67389810..3c94c4b35dc0 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -563,6 +563,9 @@ loops that truncate the stream.
            for prod in result:
                yield tuple(prod)
 
+   Before :func:`product` runs, it completely consumes the input iterables,
+   keeping pools of values in memory to generate the products.  Accordingly,
+   it only useful with finite inputs.
 
 .. function:: repeat(object[, times])