From: Anuj Nitin Bharambe <119653366+anujbharambe@users.noreply.github.com>
Date: Sat, 2 May 2026 16:55:29 +0000 (+0530)
Subject: gh-149267: Document ast.Constant.kind attribute (#149268)
X-Git-Tag: v3.15.0b1~110
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3a1df787e1e630d3d57e99226604ddceb8c47229;p=thirdparty%2FPython%2Fcpython.git

gh-149267: Document ast.Constant.kind attribute (#149268)

The kind attribute of ast.Constant was not mentioned in the
documentation. It is set to 'u' for u-prefixed string literals
and None for all other constants.

---------

Co-authored-by: Anuj Bharambe <anujnitinb@gmail.com>
---

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 49be47f15aa1..e10b8e22df0f 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -280,18 +280,25 @@ Root nodes
 Literals
 ^^^^^^^^
 
-.. class:: Constant(value)
+.. class:: Constant(value, kind)
 
    A constant value. The ``value`` attribute of the ``Constant`` literal contains the
    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`.
 
+   The ``kind`` attribute is an optional string. For string literals with a
+   ``u`` prefix, ``kind`` is set to ``'u'``. For all other
+   constants, ``kind`` is ``None``.
+
    .. doctest::
 
         >>> print(ast.dump(ast.parse('123', mode='eval'), indent=4))
         Expression(
             body=Constant(value=123))
+        >>> print(ast.dump(ast.parse("u'hello'", mode='eval'), indent=4))
+        Expression(
+            body=Constant(value='hello', kind='u'))
 
 
 .. class:: FormattedValue(value, conversion, format_spec)