https://github.com/python/cpython/commit/381020d41fb1f8b33421f01c609ba0d0edb99764
commit: 381020d41fb1f8b33421f01c609ba0d0edb99764
branch: main
author: Jelle Zijlstra <[email protected]>
committer: JelleZijlstra <[email protected]>
date: 2025-05-29T21:11:20-07:00
summary:
ast docs: Fix description of ast.Constant (#134741)
Contrary to the current docs, ast.Constant will never hold containers
such as frozenset or tuple; the Python parser only emits it for simple
literals.
For precision, add the exact list of types that may be contained in an
ast.Constant.
files:
M Doc/library/ast.rst
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index ca9a6b0712c9a2..cf22250cac6091 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -268,9 +268,9 @@ Literals
.. class:: Constant(value)
A constant value. The ``value`` attribute of the ``Constant`` literal
contains the
- Python object it represents. The values represented can be simple types
- such as a number, string or ``None``, but also immutable container types
- (tuples and frozensets) if all of their elements are constant.
+ Python object it represents. The values represented can be instances of
:class:`str`,
+ :class:`bytes`, :class:`int`, :class:`float`, :class:`complex`, and
:class:`bool`,
+ and the constants :data:`None` and :data:`Ellipsis`.
.. doctest::
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
