Copyright (C) 2006 Andrew Tomazos <andrew@tomazos.com>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
The following documentation uses Foo.jj as a hypothetical example of a JavaCC grammar file. Read it by substituting Foo for the actual name of your parser.
jjrun allows you to execute a JavaCC .jj grammar file with a single command:
$ jjrun Foo.jj < file_to_be_parsed
Standard input to jjrun is passed through to the resulting parser.
jjrun is useful for quick prototyping of new grammars, as a build tool and as a building block for a testing harnass.
This assumes you already have javacc and java installed into your path.
Download jjrun-latest.tar.gz from tomazos.com
$ wget http://tomazos.com/jjrun/jjrun-latest.tar.gz
Unpack it
$ tar zxvf jjrun-latest.tar.gz
Enter directory
$ cd jjrun-latest
Read the README
$ less README
Run the tests
$ make test
Install jjrun (defaults to /usr/bin)
$ make install
Take the src/jjrun script from the archive, make it executable and place it in your path somewhere.
Under the hood jjrun is a standard Bourne Shell script that is installed in your path.
When executed on Foo.jj it does the following things: