A Python Parser
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.9") >>> expr = module.children >>> expr PythonNode(arith_expr, [<Name: hello@1,0>, <Operator: +>, <Number: 1>]) >>> print(expr.get_code()) hello + 1 >>> name = expr.children >>> 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"
pip install parso
- 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.
- async/await are already used as keywords in Python3.6.
- from __future__ import print_function is not ignored.
- Guido van Rossum (@gvanrossum) for creating the parser generator pgen2 (originally used in lib2to3).
- Salome Schneider for the extremely awesome parso logo.
- Add basic support for Python 3.11 and 3.12
- Various small bugfixes
- Various small bugfixes
- Dropped Support for Python 2.7, 3.4, 3.5
- It’s possible to use pathlib.Path objects now in the API
- The stubs are gone, we are now using annotations
- namedexpr_test nodes are now a proper class called NamedExpr
- A lot of smaller refactorings
- Fixed a couple of smaller bugs (mostly syntax error detection in Grammar.iter_errors)
This is going to be the last release that supports Python 2.7, 3.4 and 3.5.
- Fix a lot of annoying bugs in the diff parser. The fuzzer did not find issues anymore even after running it for more than 24 hours (500k tests).
- Small grammar change: suites can now contain newlines even after a newline. This should really not matter if you don’t use error recovery. It allows for nicer error recovery.
- Add Grammar.refactor (might still be subject to change until 0.7.0)
- Add parso.normalizer.Issue.end_pos to make it possible to know where an issue ends
- Dropped Python 2.6/Python 3.3 support
- del_stmt names are now considered as a definition (for name.is_definition())
- Add include_setitem to get_definition/is_definition and get_defined_names (#66)
- Fix named expression error listing (#89, #90)
- Fix some f-string tokenizer issues (#93)
- Fix: Some unicode identifiers were not correctly tokenized
- Fix: Line continuations in f-strings are now working
- Breaking Change comp_for is now called sync_comp_for for all Python versions to be compatible with the Python 3.8 Grammar
- Added .pyi stubs for a lot of the parso API
- Small FileIO changes
- Python 3.8 support
- FileIO support, it’s now possible to use abstract file IO, support is alpha
- Fix an f-string tokenizer error
- Fix async errors in the diff parser
- A fix in iter_errors
- This is a very small bugfix release
- 20+ bugfixes in the diff parser and 3 in the tokenizer
- A fuzzer for the diff parser, to give confidence that the diff parser is in a good shape.
- Some bugfixes for f-string
- Bugfixes in the diff parser and keyword-only arguments
- Rewrote the pgen2 parser generator.
- A bugfix for the diff parser.
- Grammar files can now be loaded from a specific path.
- f-strings are now parsed as a part of the normal Python grammar. This makes it way easier to deal with them.
- Fixed a few bugs in the caching layer
- Added support for Python 3.7
- Pulling the library out of Jedi. Some APIs will definitely change.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for parso-0.8.3-py2.py3-none-any.whl