Skip to main content

A Python Parser

Project description

Travis-CI build status Coverage Status https://raw.githubusercontent.com/davidhalter/parso/master/docs/_static/logo_characters.png

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"

Resources

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.3.0 (2018-07-30)

  • Rewrote the pgen2 parser generator.

0.2.1 (2018-05-21)

  • A bugfix for the diff parser.

  • Grammar files can now be loaded from a specific path.

0.2.0 (2018-04-15)

  • f-strings are now parsed as a part of the normal Python grammar. This makes it way easier to deal with them.

0.1.1 (2017-11-05)

  • Fixed a few bugs in the caching layer

  • Added support for Python 3.7

0.1.0 (2017-09-04)

  • Pulling the library out of Jedi. Some APIs will definitely change.

Project details


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.3.0.tar.gz (378.9 kB view details)

Uploaded Source

Built Distribution

parso-0.3.0-py2.py3-none-any.whl (88.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file parso-0.3.0.tar.gz.

File metadata

  • Download URL: parso-0.3.0.tar.gz
  • Upload date:
  • Size: 378.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for parso-0.3.0.tar.gz
Algorithm Hash digest
SHA256 d250235e52e8f9fc5a80cc2a5f804c9fefd886b2e67a2b1099cf085f403f8e33
MD5 2c525d24526bd7f5566f632bc6230cb1
BLAKE2b-256 29c1fd8a3e5eec85bf160c2b1ea369fdfa585620cf753db021d5db895801e701

See more details on using hashes here.

File details

Details for the file parso-0.3.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for parso-0.3.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8105449d86d858e53ce3e0044ede9dd3a395b1c9716c696af8aa3787158ab806
MD5 10e749c3a8265688f5002a1a121470c3
BLAKE2b-256 3119ae6ded1b16b596e594dffe1916b365c658ddf93396824ed069a60da22b79

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page