]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.8] bpo-41504: Add links to asttokens, leoAst, LibCST and parso to ast docs (GH...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Tue, 11 Aug 2020 14:45:25 +0000 (07:45 -0700)
committerGitHub <noreply@github.com>
Tue, 11 Aug 2020 14:45:25 +0000 (07:45 -0700)
(cherry picked from commit e3c971ccfa58afcb2656b71b95e10b9703f2ad32)

Co-authored-by: Edward K. Ream <edreamleo@gmail.com>
https://bugs.python.org/issue41504

Doc/library/ast.rst

index 6ca27609e93bae5bf92e8a420add10b82b1ca7a9..67c6392ad7d2c49918301c4da2bc75708447d6ab 100644 (file)
@@ -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