Skip to content

gh-141984: Split Parenthesized form docs into "groups" and "tuple displays" #144964

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
encukou wants to merge 4 commits into from
Closed

gh-141984: Split Parenthesized form docs into "groups" and "tuple displays" #144964

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8caafe3
Start on enclosures
encukou Jan 21, 2026
8014206
Work on tuple displays
encukou Feb 11, 2026
97f8bd0
Merge in the main branch
encukou Feb 18, 2026
a703113
Polish groups & tuple displays
encukou Feb 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Merge in the main branch
  • Loading branch information
@encukou
encukou committed Feb 18, 2026
commit 97f8bd00d1dcdc22ecf117166694798a4efeac52
38 changes: 35 additions & 3 deletions Doc/reference/expressions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,18 +52,50 @@ The simplest atoms are :ref:`names <identifiers>` or literals.
Forms enclosed in parentheses, brackets or braces are also categorized
syntactically as atoms.

.. productionlist:: python-grammar
atom: `identifier` | `literal` | `enclosure`
Formally, the syntax for atoms is:

.. grammar-snippet::
:group: python-grammar

atom:
| 'True'
| 'False'
| 'None'
| '...'
| `identifier`
| `literal`
| `enclosure`
enclosure:
| (`group` | `tuple` | `yield_atom` | `generator_expression`) # in (parentheses)
| `list_display`
| `dict_display`
| `set_display`
| `yield_atom`


.. _atom-singletons:

Built-in constants
------------------

The keywords ``True``, ``False``, and ``None`` name
:ref:`built-in constants <built-in-consts>`.
The token ``...`` names the :py:data:`Ellipsis` constant.

Evaluation of these atoms yields the corresponding value.

.. note::

Several more built-in constants are available as global variables,
but only the ones mentioned here are :ref:`keywords <keywords>`.
In particular, these names cannot be reassigned or used as attributes:

.. code-block:: pycon

>>> False = 123
File "<input>", line 1
False = 123
^^^^^
SyntaxError: cannot assign to False

.. _atom-identifiers:

Expand Down
You are viewing a condensed version of this merge commit. You can view the full changes here.