parso - A Python Parser
***********************

Release v0.7.1. (Installation)

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"


Docs
====

* Installation and Configuration

  * The preferred way (pip)

  * From git

  * Manual installation from a downloaded package (not recommended)

* Usage

  * Loading a Grammar

  * Grammar methods

  * Error Retrieval

  * Utility

  * Used By

* Parser Tree

  * Parser Tree Base Classes

  * Python Parser Tree

  * Utility

* Development

  * Deprecations Process

  * Testing


Resources
=========

* Source Code on Github

* Travis Testing

* Python Package Index
