Document unpacking in generator expressions (PEP 798) #159061

Activity

1. rik

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Oct 9, 2026
2. github-project-automation

   added this to docs issueson Oct 9, 2026
3. github-project-automation

   moved this to Todo in docs issueson Oct 9, 2026
4. adqm commented on Oct 9, 2026

   

   adqm

   on Oct 9, 2026

   Contributor

   More actions

   Thanks @rik! I agree that unpacking in generator expressions is not as well documented as the other pieces of PEP 798. There are a few places where we did change the docs to reference unpacking in generator expressions, though:

   • The grammar for comprehensions in section 6.2.6.5 of the Expressions page in the language reference was updated to reflect the changes to the grammar that allow unpacking inside of generator expressions
     • It looks like there was some reorganization of that page after the original PEP 798 PR was merged, in which a more-general "Added in 3.15" referring to the grammar change might have been lost.
     • Maybe adding an example and an "Added in 3.15" to section 6.2.7 of that page would be an improvement?
   • The examples in section 9.10 of the tutorial make use of unpacking, though it's not called out explicitly like it is for the list/set/dict comprehensions, so maybe we could use an extra sentence or two that explicitly state that unpacking in be used in generator expressions just like in list/set comprehensions.

   Will wait to see what others say, but I'd be happy to submit a quick PR if others agree that it's worth making some changes.
5. Marwan-verse commented on Oct 12, 2026

   

   Marwan-verse

   on Oct 12, 2026 – with ChatGPT Codex Connector

   More actions

   I opened #159268 to add a flattening example and a Python 3.15 version note to the Generator expressions section in the Language Reference. AI disclosure: the documentation change was prepared with OpenAI Codex. The documentation build was not run.