From 2b83429d0186b3b88bbe31fea59a30c24d6c3c93 Mon Sep 17 00:00:00 2001 From: Anuj Nitin Bharambe <119653366+anujbharambe@users.noreply.github.com> Date: Sat, 2 May 2026 22:25:29 +0530 Subject: [PATCH] gh-149267: Document ast.Constant.kind attribute (GH-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. --------- (cherry picked from commit 3a1df787e1e630d3d57e99226604ddceb8c47229) Co-authored-by: Anuj Nitin Bharambe <119653366+anujbharambe@users.noreply.github.com> Co-authored-by: Anuj Bharambe --- Doc/library/ast.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst index 31c406c62b171f..6e9b96aa89469f 100644 --- a/Doc/library/ast.rst +++ b/Doc/library/ast.rst @@ -274,18 +274,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)