| 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) |
|
|
