Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

PyParsing – A Python Parsing Module

Version Build Status Coverage License Python versions pyparsing

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.parseString(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 parseString() 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 __init__.py file.

History

See CHANGES file.

Metadata

Release files for pyparsing 3.2.0b2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyparsing 3.2.0b2
File Size Uploaded
pyparsing-3.2.0b2.tar.gz 913.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyparsing 3.2.0b2
File Interpreter ABI Platform
pyparsing-3.2.0b2-py3-none-any.whl Python 3 none any Details

Total release size: 1.0 MB

Release files / pyparsing-3.2.0b2.tar.gz

Download URL pyparsing-3.2.0b2.tar.gz
Size 913.1 kB
Tags Source
SHA-256 checksum
How to use checksums
4be19b56e8cab9347870c2ba8cfe1e7d18944e8705f41784c3243db531146a0a
BLAKE2b-256 checksum
How to use checksums
a6daf0b8f9d6655cf9859e5bf31b0d63e5fa2722e4d8d9372245721e0d62930f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.3

Release files / pyparsing-3.2.0b2-py3-none-any.whl

Download URL pyparsing-3.2.0b2-py3-none-any.whl
Size 105.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5e258463e5d13a9848f2722b481cd92948b4108088d6e7d3c4d8d02e754ad3de
BLAKE2b-256 checksum
How to use checksums
0a0839c2a707cb30d8fd50ffdc36a998a7b1d5137c9d31ac2e6b39b5ed08dd75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.3

Release history Release notifications | RSS feed

3.3.3

2 release files

3.3.2

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.5

2 release files

3.2.4

2 release files

3.2.3

2 release files

3.2.2

2 release files

3.2.1

2 release files

3.2.0

2 release files

This release

3.2.0b2 This release

2 release files

3.1.4

2 release files

3.1.3

2 release files

3.1.2

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.9

2 release files

3.0.8

2 release files

3.0.7

2 release files

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.4.7

2 release files

2.4.6

2 release files

2.4.5

2 release files

2.4.4

2 release files

2.4.3

2 release files

2.4.2

2 release files

2.4.0

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

7 release files

2.1.9

8 release files

2.1.8

8 release files

2.1.7

8 release files

2.1.6

8 release files

2.1.5

8 release files

2.1.4

8 release files

2.1.3

7 release files

2.1.2

8 release files

2.1.1

8 release files

2.1.0

8 release files

2.0.7

9 release files

2.0.6

8 release files

2.0.5

8 release files

2.0.4

8 release files

2.0.3

10 release files

2.0.2

9 release files

2.0.1

8 release files

2.0.0

6 release files

1.5.7

5 release files

1.5.6

9 release files

1.5.5

9 release files

1.5.4

9 release files

1.5.3

9 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

1 release file

1.4.11

1 release file

1.4.8

1 release file

1.4.7

1 release file

1.4.6

1 release file

1.3.3

1.2

1.1.2

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page