[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
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
[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>
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 6ca27609e93ba..67c6392ad7d2c 100644
@@ -343,5 +343,24 @@ and classes for traversing abstract syntax trees:
- `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
+ `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
+ `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