[Python-checkins] [3.8] bpo-41504: Add links to asttokens, leoAst, LibCST and parso to ast docs (GH-21773) (GH-21829)
Miss Islington (bot)
webhook-mailer at python.org
Tue Aug 11 10:45:31 EDT 2020
https://github.com/python/cpython/commit/7b3ceaa71051d811bfee0b62ef9cb0fd2121c7ee
commit: 7b3ceaa71051d811bfee0b62ef9cb0fd2121c7ee
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2020-08-11T07:45:25-07:00
summary:
[3.8] bpo-41504: Add links to asttokens, leoAst, LibCST and parso to ast docs (GH-21773) (GH-21829)
(cherry picked from commit e3c971ccfa58afcb2656b71b95e10b9703f2ad32)
Co-authored-by: Edward K. Ream <edreamleo at gmail.com>
https://bugs.python.org/issue41504
files:
M Doc/library/ast.rst
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 6ca27609e93ba..67c6392ad7d2c 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -343,5 +343,24 @@ and classes for traversing abstract syntax trees:
.. seealso::
- `Green Tree Snakes <https://greentreesnakes.readthedocs.io/>`_, an external documentation resource, has good
- details on working with Python ASTs.
+ `Green Tree Snakes <https://greentreesnakes.readthedocs.io/>`_, an external
+ documentation resource, has good details on working with Python ASTs.
+
+ `ASTTokens <https://asttokens.readthedocs.io/en/latest/user-guide.html>`_
+ annotates Python ASTs with the positions of tokens and text in the source
+ code that generated them. This is helpful for tools that make source code
+ transformations.
+
+ `leoAst.py <http://leoeditor.com/appendices.html#leoast-py>`_ unifies the
+ token-based and parse-tree-based views of python programs by inserting
+ two-way links between tokens and ast nodes.
+
+ `LibCST <https://libcst.readthedocs.io/>`_ parses code as a Concrete Syntax
+ Tree that looks like an ast tree and keeps all formatting details. It's
+ useful for building automated refactoring (codemod) applications and
+ linters.
+
+ `Parso <https://parso.readthedocs.io>`_ is a Python parser that supports
+ error recovery and round-trip parsing for different Python versions (in
+ multiple Python versions). Parso is also able to list multiple syntax errors
+ in your python file.
\ No newline at end of file
More information about the Python-checkins
mailing list