pyparsing

pyparsing - Classes and methods to define and execute parsing grammars

88 个版本 Python >=3.9

安装

pip install pyparsing

poetry add pyparsing

pipenv install pyparsing

conda install pyparsing

描述

PyParsing -- A Python Parsing Module

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 <https://en.wikipedia.org/wiki/Parsing_expression_grammar>__ .]

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

.. code:: python

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 <https://pyparsing-docs.readthedocs.io/en/latest/>. Additional documentation resources and project info are listed in the online GitHub wiki <https://github.com/pyparsing/pyparsing/wiki>. An entire directory of examples can be found here <https://github.com/pyparsing/pyparsing/tree/master/examples>__.

AI Instructions

There are also instructions for AI agents to use when helping you to create your parser. They can be pulled from the GitHub project repository, at pyparsing/ai/best_practices.md. You can also tell the AI to access them programmatically after installing pyparsing, either from the CLI with python -m pyparsing.ai.show_best_practices or within python with import pyparsing; pyparsing.show_best_practices().

License

MIT License. See header of the pyparsing __init__.py <https://github.com/pyparsing/pyparsing/blob/master/pyparsing/__init__.py#L1-L23>__ file.

History

See CHANGES <https://github.com/pyparsing/pyparsing/blob/master/CHANGES>__ file.

Performance benchmarks

For usage instructions and details on the performance benchmark suite, see tests/README.md in this repository.

.. |Build Status| image:: https://github.com/pyparsing/pyparsing/actions/workflows/ci.yml/badge.svg :target: https://github.com/pyparsing/pyparsing/actions/workflows/ci.yml

.. |Coverage| image:: https://codecov.io/gh/pyparsing/pyparsing/branch/master/graph/badge.svg :target: https://codecov.io/gh/pyparsing/pyparsing

.. |Version| image:: https://img.shields.io/pypi/v/pyparsing?style=flat-square :target: https://pypi.org/project/pyparsing/ :alt: Version

.. |License| image:: https://img.shields.io/pypi/l/pyparsing.svg?style=flat-square :target: https://pypi.org/project/pyparsing/ :alt: License

.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/pyparsing.svg?style=flat-square :target: https://pypi.org/project/python-liquid/ :alt: Python versions

.. |Snyk Score| image:: https://snyk.io//advisor/python/pyparsing/badge.svg :target: https://snyk.io//advisor/python/pyparsing :alt: pyparsing

分类

Development Status :: 5 - Production/Stable Intended Audience :: Developers Intended Audience :: Information Technology Operating System :: OS Independent Programming Language :: Python Programming Language :: Python :: 3 Programming Language :: Python :: 3 :: Only Programming Language :: Python :: 3.10 Programming Language :: Python :: 3.11 Programming Language :: Python :: 3.12 Programming Language :: Python :: 3.13 Programming Language :: Python :: 3.14 Programming Language :: Python :: 3.9 Programming Language :: Python :: Implementation :: CPython Programming Language :: Python :: Implementation :: PyPy Topic :: Software Development :: Compilers Topic :: Text Processing Typing :: Typed

版本列表

3.3.2 2026-01-21

3.3.1 2025-12-23

3.3.0 2025-12-22

3.3.0b1 2025-11-26

3.3.0a1 2025-09-29

3.2.5 2025-09-21

3.2.4 2025-09-13

3.2.3 2025-03-25

3.2.2 2025-03-24

3.2.1 2024-12-31

3.2.0 2024-10-13

3.2.0rc1 2024-10-05

3.2.0b3 2024-09-29

3.2.0b2 2024-09-24

3.2.0b1 2024-09-12

3.1.4 2024-08-25

3.1.3 2024-08-25

3.1.2 2024-03-06

3.1.1 2023-07-30

3.1.0 2023-06-18

3.1.0b2 2023-05-20

3.1.0b1 2023-04-08

3.1.0a1 2023-03-08

3.0.9 2022-05-10

3.0.8 2022-04-10

3.0.7 2022-01-21

3.0.6 2021-11-12

3.0.5 2021-11-07

3.0.4 2021-10-30

3.0.3 2021-10-27

3.0.2 2021-10-27

3.0.1 2021-10-24

3.0.0 2021-10-23

3.0.0rc2 2021-10-02

3.0.0rc1 2021-09-09

3.0.0b3 2021-08-08

3.0.0b2 2020-12-30

3.0.0b1 2020-11-03

3.0.0a2 2020-06-28

3.0.0a1 2020-04-05

2.4.7 2020-04-05

2.4.6 2019-12-25

2.4.5 2019-11-10

2.4.4 2019-11-05

2.4.3 2019-11-05

2.4.2 2019-07-30

2.4.1.1 2019-07-25

2.4.0 2019-04-08

2.4.2a1 2019-07-24

2.3.1 2019-01-13

2.3.0 2018-10-31

2.2.2 2018-09-30

2.2.1 2018-09-18

2.2.0 2017-03-06

2.1.10 2016-10-07

2.1.9 2016-09-10

2.1.8 2016-08-15

2.1.7 2016-08-11

2.1.6 2016-08-08

2.1.5 2016-06-13

2.1.4 2016-05-13

2.1.3 2016-05-11

2.1.2 2016-05-11

2.1.1 2016-03-22

2.1.0 2016-02-07

2.0.7 2015-12-31

2.0.6 2015-11-14

2.0.5 2015-10-29

2.0.4 2015-10-29

2.0.3 2014-11-19

2.0.2 2014-04-13

2.0.1 2013-07-17

2.0.0 2013-02-27

1.5.7 2013-02-27

1.5.6 2011-06-29

1.5.5 2010-08-12

1.5.4 2010-08-11

1.5.3 2010-06-25

1.5.2 2009-04-20

1.5.1 2008-10-18

1.5.0 2008-06-01

1.4.11 2008-02-11

1.4.8 2007-10-07

1.4.7 2007-07-25

1.4.6 2007-06-30

1.3.3

1.2

1.1.2