Disclaimer - RopleyIT/GLRParser GitHub Wiki

The ParseLR Toolkit, examples and associated documentation are covered by the following disclaimer. If you download and use any of this software, you are agreeing to be bound by these terms and conditions:

While Ropley Information Technology Ltd make every effort to deliver quality software, we do not guarantee that the products we offer for free download and use are without defects. Such software is provided “as is," and you use the software at your own risk. We make no warranties as to performance, merchantability, fitness for a particular purpose, or any other warranties whether expressed or implied. No oral or written communication from or information provided by Ropley Information Technology Ltd shall create a warranty. Under no circumstances shall Ropley Information Technology Ltd be liable for direct, indirect, special, incidental, or consequential damages resulting from the use, misuse, or inability to use this software, even if Ropley Information Technology Ltd has been advised of the possibility of such damages.

Clicking on any of the download links below will constitute your agreement to these terms and conditions. Do not download this software if you do not agree to these terms.

Click here to download a ZIP file containing the latest version of the ParseLR.exe command line tool built for Windows, and the ParserGenerator and Parsing DLLs. The documentation is maintained here on the GitHub Wiki. When unzipping the toolkit, create a folder for it, and unzip into that folder. If you are planning to use this from scripts, make sure that the folder is added to your PATH.

To use the parser generator on a Windows machine, you will need to place the ParseLR.exe file and all the DLLs in the Kit folder into some chosen executable folder, and make sure that folder has been added to your environment path. At present, the parser generator has been designed to be used as a command line or script-based tool. Use the Windows command script or a PowerShell script to invoke it.

If you are planing to run the parser generator on a Linux or a Mac environment, you will need to clone the repository from this GitHub site, and build the ParseLR project found in the ParseLR folder. You can do this using the DotNET CLI tools, or from the command pane inside Visual Studio Code, if you have installed it.

There are coded samples included in the GitHub repository (each of which is also covered by the disclaimer above), that you can use to see how to construct applications that employ the parsers generated by this toolkit.

One sample makes use of an offline parser, and implements a desktop calculator as a simple windows application. The calculator demonstrates the use of both LR(1) parsing and GLR parsing of arithmetic expressions. More details about the example are given here.

The second example is a simplified English sentence parser. This example is implemented using an inline parser, and also demonstrates the use of guard conditions on terminal and non-terminal tokens. A brief description of this example is available here.

Lastly, an example of an inline finite state machine using the grammar-driven finite state machine generator in ParseLR is described here. This example implements a simple traffic light controlled pedestrian crossing.