picireny 17.1

Requirements

• Python >= 3.4

• pip and setuptools Python packages (the latter is automatically installed by pip).

• ANTLR v4

• Java SE >= 7 JRE or JDK (the latter is optional, only needed if Java is used as the parser language)

Install

The quick way:

pip install picireny

Alternatively, by cloning the project and running setuptools:

python setup.py install

Once the project is installed, a helper script becomes available that downloads the right version of the ANTLR v4 tool jar:

picireny-install-antlr4

Usage

picireny uses the same CLI as picire and hence accepts the same options. On top of the inherited ones, picireny accepts several further arguments:

• --grammars (required): List of grammars describing the input format. (You can write them by hand or simply download them from the ANTLR v4 grammars repository.

• --start-rule (required): Name of the rule where parsing has to start.

• --antlr (optional): Path the ANTLR tool jar.

• --parser (optional): Language of the generated parser. Currently ‘python’ (default) and ‘java’ targets (faster, but needs JDK) are supported.

• --islands (optional): File describing how to process island grammars if needed.

Example usage to reduce an HTML file:

picireny --input=<path/to/the/input.html> --test=<path/to/the/tester> \
         --grammars "HTMLLexer.g4 HTMLParser.g4" --start-rule document \
         --parallel --subset-iterator=skip --complement-iterator=backward

Compatibility

picireny was tested on:

• Linux (Ubuntu 14.04 / 15.10)

• Mac OS X (OS X El Capitan - 10.11).

Copyright and Licensing

See LICENSE.