crackercat / awesome-python-ast

Python tools, libraries and resources about AST (as in Abstract Syntax Trees)

awesome-python-ast

Python tools, libraries and resources about AST (as in Abstract Syntax Trees)

Online resources

• brown-water-python

  "extended documentation for effectively working with the tokenize module"

  Project of Aaron Meurer | Repo

• greentreesnakes

  "the missing Python AST docs"

  Project of Thomas Kluyver | Repo.

Tools

• astmonkey - Set of tools to play with Python AST
• astor - AST read/write
• astpath - A command-line search utility for Python ASTs using XPath syntax.
• astpretty - Pretty print the output of python stdlib ast.parse.
• astroid - A common base representation of python source code for pylint and other projects
• astsearch - Search through ASTs using XPath syntax
• astunparse - a factored out version of unparse found in the Python source distribution
• baron - a Full Syntax Tree (FST) library
• parso - parser that supports error recovery and round-trip parsing
• redbaron - Bottom-up approach to refactoring in python
• show_ast - An IPython notebook plugin for visualizing ASTs.
• tokenize-rt - A wrapper around the stdlib tokenize which roundtrips.

Unused code detection

• dead
• vulture

Formatters

• autopep8 - A tool that automatically formats Python code to conform to the PEP 8 style guide
• black - The uncompromising Python code formatter | Online demo
• yapf - configurable formatter from Google | Online demo

Linters

• flake8 - glues together pycodestyle, pyflakes, mccabe, and third-party plugins to check the style and quality of code
• mccabe - McCabe complexity checker
• pycodestyle - former pep8. Check your Python code against some of the style conventions in PEP 8.
• pydocstyle - docstring style checker
• pyflakes - A simple program which checks Python source files for errors.
• pylint - code analysis tool which looks for programming errors, helps enforcing a coding standard, sniffs for code smells and offers simple refactoring suggestions.

Import sorters

• isort - sort imports alphabetically, and automatically separated into sections
• reorder_python_imports - reordering python imports

Other

• add-trailing-comma - A tool (and pre-commit hook) to automatically add trailing commas to calls and literals.
• pyupgrade - A tool (and pre-commit hook) to automatically upgrade syntax for newer versions of the language.
• yesqa - A tool (and pre-commit hook) to automatically remove unnecessary # noqa comments

Online tools

• python-ast-explorer

Articles

2010-02-22: Instrumenting the AST

Code examples

TODOs

• common dependencies
• "getting into" howto
• static/dynamic code analysis
• pluggable or not