|
r""" |
|
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. |
|
|
|
.. _jedi: https://github.com/davidhalter/jedi |
|
|
|
A simple example: |
|
|
|
>>> import parso |
|
>>> module = parso.parse('hello + 1', version="3.9") |
|
>>> 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" |
|
""" |
|
|
|
from parso.parser import ParserSyntaxError |
|
from parso.grammar import Grammar, load_grammar |
|
from parso.utils import split_lines, python_bytes_to_unicode |
|
|
|
|
|
__version__ = '0.8.3' |
|
|
|
|
|
def parse(code=None, **kwargs): |
|
""" |
|
A utility function to avoid loading grammars. |
|
Params are documented in :py:meth:`parso.Grammar.parse`. |
|
|
|
:param str version: The version used by :py:func:`parso.load_grammar`. |
|
""" |
|
version = kwargs.pop('version', None) |
|
grammar = load_grammar(version=version) |
|
return grammar.parse(code, **kwargs) |
|
|
