Skip to main content

Python parsing module

Project description

PyParsing – A Python Parsing Module

Build Status Coverage

Introduction

The pyparsing module is an alternative approach to creating and executing simple grammars, vs. the traditional lex/yacc approach, or the use of regular expressions. The pyparsing module provides a library of classes that client code uses to construct the grammar directly in Python code.

[Since first writing this description of pyparsing in late 2003, this technique for developing parsers has become more widespread, under the name Parsing Expression Grammars - PEGs. See more information on PEGs here .]

Here is a program to parse "Hello, World!" (or any greeting of the form "salutation, addressee!"):

from pyparsing import Word, alphas
greet = Word(alphas) + "," + Word(alphas) + "!"
hello = "Hello, World!"
print(hello, "->", greet.parse_string(hello))

The program outputs the following:

Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory class names, and the use of ‘+’, ‘|’ and ‘^’ operator definitions.

The parsed results returned from parse_string() is a collection of type ParseResults, which can be accessed as a nested list, a dictionary, or an object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:

  • extra or missing whitespace (the above program will also handle "Hello,World!", "Hello , World !", etc.)

  • quoted strings

  • embedded comments

The examples directory includes a simple SQL parser, simple CORBA IDL parser, a config file parser, a chemical formula parser, and a four- function algebraic notation parser, among many others.

Documentation

There are many examples in the online docstrings of the classes and methods in pyparsing. You can find them compiled into online docs. Additional documentation resources and project info are listed in the online GitHub wiki. An entire directory of examples can be found here.

License

MIT License. See header of the pyparsing.py file.

History

See CHANGES file.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyparsing-3.0.0b3.tar.gz (722.9 kB view details)

Uploaded Source

Built Distribution

pyparsing-3.0.0b3-py3-none-any.whl (88.7 kB view details)

Uploaded Python 3

File details

Details for the file pyparsing-3.0.0b3.tar.gz.

File metadata

  • Download URL: pyparsing-3.0.0b3.tar.gz
  • Upload date:
  • Size: 722.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.2.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

File hashes

Hashes for pyparsing-3.0.0b3.tar.gz
Algorithm Hash digest
SHA256 e96a96967098a5221a78bf94d72930cd1cfaf0ab88dae2ea6bfc2b8b8ccb1930
MD5 02c048faff3a370dc58205aa07c40fda
BLAKE2b-256 a37a274869ae8f5e64ca94c1a1b0951e2a29176d2324d8313c14f0849ee7a6c1

See more details on using hashes here.

File details

Details for the file pyparsing-3.0.0b3-py3-none-any.whl.

File metadata

  • Download URL: pyparsing-3.0.0b3-py3-none-any.whl
  • Upload date:
  • Size: 88.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.2.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

File hashes

Hashes for pyparsing-3.0.0b3-py3-none-any.whl
Algorithm Hash digest
SHA256 10f1886e70da7b76ca1b4cf9bbd60f708ef037892496d5cb7c77ab2982412b2d
MD5 8c35856c2021604a9067a74b351a1ad2
BLAKE2b-256 2158746ccd590ec2c1cae28b2a7d1666554aae5a412e8f0062655807a3227e58

See more details on using hashes here.

Supported by

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