gh-127303: Add docs for token.EXACT_TOKEN_TYPES (GH-127304)

--------- (cherry picked from commit dd3a87d) Co-authored-by: Илья Любавский <[email protected]> Co-authored-by: Terry Jan Reedy <[email protected]> Co-authored-by: Tomas R. <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]>
python · Nov 29, 2024 · 3160185 · 3160185
1 parent 7d175ca
commit 3160185
Show file tree

Hide file tree

Showing 5 changed files with 13 additions and 2 deletions.
diff --git a/Doc/library/token.rst b/Doc/library/token.rst
@@ -79,6 +79,13 @@ the :mod:`tokenize` module.
    ``type_comments=True``.
 
 
+.. data:: EXACT_TOKEN_TYPES
+
+   A dictionary mapping the string representation of a token to its numeric code.
+
+   .. versionadded:: 3.8
+
+
 .. versionchanged:: 3.5
    Added :data:`AWAIT` and :data:`ASYNC` tokens.
 

diff --git a/Lib/token.py b/Lib/token.py
diff --git a/Misc/ACKS b/Misc/ACKS
@@ -1139,6 +1139,7 @@ Mark Lutz
 Taras Lyapun
 Jim Lynch
 Mikael Lyngvig
+Ilya Lyubavski
 Jeff MacDonald
 John Machin
 Andrew I MacIntyre

diff --git a/Misc/NEWS.d/next/Library/2024-11-27-16-06-10.gh-issue-127303.asqkgh.rst b/Misc/NEWS.d/next/Library/2024-11-27-16-06-10.gh-issue-127303.asqkgh.rst
@@ -0,0 +1 @@
+Publicly expose :data:`~token.EXACT_TOKEN_TYPES` in :attr:`!token.__all__`.
diff --git a/Tools/build/generate_token.py b/Tools/build/generate_token.py
@@ -226,7 +226,8 @@ def make_rst(infile, outfile='Doc/library/token-list.inc'):
 # {AUTO_GENERATED_BY_SCRIPT}
 '''
 token_py_template += '''
-__all__ = ['tok_name', 'ISTERMINAL', 'ISNONTERMINAL', 'ISEOF']
+__all__ = ['tok_name', 'ISTERMINAL', 'ISNONTERMINAL', 'ISEOF',
+           'EXACT_TOKEN_TYPES']
 
 %s
 N_TOKENS = %d
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Publicly expose :data:`~token.EXACT_TOKEN_TYPES` in :attr:`!token.__all__`.