]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.13] ast docs: Fix description of ast.Constant (GH-134741) (#134912)
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Fri, 30 May 2025 04:19:04 +0000 (06:19 +0200)
committerGitHub <noreply@github.com>
Fri, 30 May 2025 04:19:04 +0000 (04:19 +0000)
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.
(cherry picked from commit 381020d41fb1f8b33421f01c609ba0d0edb99764)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Doc/library/ast.rst

index 55389f53478870b7a4cec440a95f122c0f2c96ec..eb5bcd00122d974bcac8de77a601780e6e78336c 100644 (file)
@@ -263,9 +263,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::