A Python Parser
Project description
Parso 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.
Parso has been battle-tested by jedi. It was pulled out of jedi to be useful for other projects as well.
Parso consists of a small API to parse Python and analyse the syntax tree.
A simple example:
>>> import parso >>> module = parso.parse('hello + 1', version="3.6") >>> expr = module.children[0] >>> expr PythonNode(arith_expr, [<Name: hello@1,0>, <Operator: +>, <Number: 1>]) >>> print(expr.get_code()) hello + 1 >>> name = expr.children[0] >>> name <Name: hello@1,0> >>> name.end_pos (1, 5) >>> expr.end_pos (1, 9)
To list multiple issues:
>>> grammar = parso.load_grammar() >>> module = grammar.parse('foo +\nbar\ncontinue') >>> error1, error2 = grammar.iter_errors(module) >>> error1.message 'SyntaxError: invalid syntax' >>> error2.message "SyntaxError: 'continue' not properly in loop"
Ressources
Installation
pip install parso
Future
- There will be better support for refactoring and comments. Stay tuned.
- There’s a WIP PEP8 validator. It’s however not in a good shape, yet.
Known Issues
- async/await are already used as keywords in Python3.6.
- from __future__ import print_function is not ignored.
Acknowledgements
- Guido van Rossum (@gvanrossum) for creating the parser generator pgen2 (originally used in lib2to3).
- Salome Schneider for the extremely awesome parso logo.
Changelog
0.1.0 (2017-05-30)
- Pulling the library out of Jedi. Some APIs will definitely change.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
parso-0.1.0.tar.gz
(378.8 kB
view hashes)
Built Distribution
parso-0.1.0-py2.py3-none-any.whl
(89.1 kB
view hashes)
Close
Hashes for parso-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b573acb69f66a970197b5fdbbdfad3b8a417a520e383133b2b4e708f104bfc9a |
|
MD5 | df885e43db7976d1b0abbc56c0b22bad |
|
BLAKE2-256 | fcaf32b2a0d8b2e5d5c82f6f29752a243255beb4b281617e9581b3d7784aec7a |