From ff14b62406be4ab45e243bbeeeec3a00c3f57aee Mon Sep 17 00:00:00 2001 From: Marwan <128292743+Marwan-verse@users.noreply.github.com> Date: Mon, 12 Oct 2026 22:38:47 +0100 Subject: [PATCH] Document unpacking in generator expressions --- Doc/reference/expressions.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst index 2e0b6621eb11c86..d134290d4faeec1 100644 --- a/Doc/reference/expressions.rst +++ b/Doc/reference/expressions.rst @@ -967,6 +967,17 @@ For example:: >>> iterator at ...> +Like list comprehensions, generator expressions can unpack the iterable +produced by their leading expression by prefixing it with ``*``. +The elements of each iterable are yielded in order:: + + >>> flattened = (*values for values in [(1, 2), (3, 4)]) + >>> list(flattened) + [1, 2, 3, 4] + +.. versionadded:: 3.15 + Unpacking in generator expressions was introduced in :pep:`798`. + At runtime, a generator expression evaluates to a :term:`generator iterator` which yields the same values as the corresponding list comprehension::