Yet Another Python Parser System
Python TeX GAP Shell
Latest commit 701b4cd May 16, 2014 @smurfix Also test with pypy
just for the heck of it
Failed to load latest commit information.
doc missed a python2-ism May 7, 2014
examples more Py3 fixes May 7, 2014
test Initial version in git Sep 9, 2009
yapps expand spaces May 16, 2014
.travis.yml Also test with pypy May 16, 2014
LICENSE Initial version in git Sep 9, 2009
NOTES Initial version in git Sep 9, 2009 Change version to 2.2.0 (semantic versioning) May 16, 2014 Add a test script and a YML file for travis-CI May 7, 2014
yapps2 Mostly packaging changes Jan 19, 2013

YAPPS: Yet Another Python Parser System

For the most complete and excellent documentation (e.g. manual with examples) and info, please see original project website:

YAPPS is an easy to use parser generator that is written in Python and generates Python code. There are several parser generator systems already available for Python, but this parser has different goals: Yapps is simple, very easy to use, and produces human-readable parsers.

It is not the fastest or most powerful parser. Yapps is designed to be used when regular expressions are not enough and other parser systems are too much: situations where you might otherwise write your own recursive descent parser.

This fork contains several upward-compatible enhancements to the original YAPPS source, originally included in debian package:

  • Handle stacked input ("include files").
  • Augmented ignore-able patterns (can parse multi-line C comments correctly).
  • Better error reporting.
  • Read input incrementally.


It's a regular package for Python 2.7 (not 3.X, but there are links to 3.X patches listed on the original author website), but not in pypi, so can be installed from a checkout with something like that:

% python install

Better way would be to use pip to install all the necessary dependencies as well:

% pip install 'git+'

Note that to install stuff in system-wide PATH and site-packages, elevated privileges are often required. Use "install --user", ~/.pydistutils.cfg or virtualenv to do unprivileged installs into custom paths.

Alternatively, ./yapps2 can be run right from the checkout tree, without any installation.

No extra package dependencies.