I've just uploaded to SourceForge and PyPI the latest update to
pyparsing, version 1.5.1. It has been a couple of months since
1.5.0 was released, and a number of bug-fixes and enhancements
have accumulated in SVN, so time for a release!
Here's what's new in Pyparsing 1.5.1:
- Added __dir__() methods to ParseBaseException and ParseResults,
to support new dir() behavior in Py2.6 and Py3.0. If dir() is
called on a ParseResults object, the returned list will include
the base set of attribute names, plus any results names that are
- Added new helper method originalTextFor, to replace the use of
the current keepOriginalText parse action. The implementation
of originalTextFor is simpler and faster than keepOriginalText,
and does not depend on using the inspect or imp modules.
- Added failOn argument to SkipTo, so that grammars can define
literal strings or pyparsing expressions which, if found in the
skipped text, will cause SkipTo to fail. Useful to prevent
SkipTo from reading past terminating expression. Instigated by
question posed by Aki Niimura on the pyparsing wiki.
Pyparsing 1.5.1 also includes these bug-fixes (more details in
the CHANGES file included with the source distributions):
- Fixed bug in nestedExpr if multi-character expressions are given
for nesting delimiters.
- Removed dependency on xml.sax.saxutils.escape, and included
internal implementation instead.
- Fixed typo in ParseResults.insert.
- Fixed bug in '-' error stop, when '-' operator is used inside a
- Reverted generator expression to use list comprehension, for
better compatibility with Python 2.3.
- Fixed bug in parseString(parseAll=True), when the input string
ends with a comment or whitespace.
- Fixed bug in LineStart and LineEnd that did not recognize any
special whitespace chars defined using ParserElement.setDefault-
- Forward class is now more tolerant of subclassing.
(Python 3.0 uses syntax for catching exceptions that is incompatible
with Python versions pre 2.6, so there is no way for me to support
both existing Python releases and Python 3.0 with a common source code
base. For those who wish to try out pyparsing with Python 3.0, there
is a file pyparsing_py3.py in the SourceForge Subversion repository.
I have done some testing of this code, but many of my unit tests
need to be converted to Python 3.)
Download pyparsing 1.5.1 at http://sourceforge.net/projects/pyparsing/.
The pyparsing Wiki is at http://pyparsing.wikispaces.com
Pyparsing is a pure-Python class library for quickly developing
recursive-descent parsers. Parser grammars are assembled directly in
the calling Python code, using classes such as Literal, Word,
OneOrMore, Optional, etc., combined with operators '+', '|', and '^'
for And, MatchFirst, and Or. No separate code-generation or external
files are required. Pyparsing can be used in many cases in place of
regular expressions, with shorter learning curve and greater
readability and maintainability. Pyparsing comes with a number of
parsing examples, including:
- "Hello, World!" (English, Korean, Greek, and Spanish)
- chemical formulas
- configuration file parser
- web page URL extractor
- 5-function arithmetic expression parser
- subset of CORBA IDL
- chess portable game notation
- simple SQL parser
- Mozilla calendar file parser
- EBNF parser/compiler
- Python value string parser (lists, dicts, tuples, with nesting)
(safe alternative to eval)
- HTML tag stripper
- S-expression parser
- macro substitution preprocessor
- TAP output parser