mythslove / grappa-debugger Goto Github PK

This project is licensed under both LGPLv3 and ASL 2.0. See file LICENSE for more details.

The current version is 0.3.0. You can download a self contained jar with a main on Bintray.

This project requires Java 8 and JavaFX 8; it has been developed using JDK 1.8u25 from Oracle.

It is recommended that you run this program with a version at least this recent. Among other things, exception handling relies on the default uncaught exception handler working correctly with JavaFX. Apparently, this was not the case with earlier versions of JDK 8. Unfortunately I don't know the full details.

This is a GUI application to debug parsers written with grappa.

It uses trace files generated by a parser runner originally developed for the next grappa iteration, 2.0.x. However, the parsing runner used to generate the trace files has been backported to grappa 1.0.x and, by extension, parboiled 1.1.x as well.

For those among you in the know: this tracing parser does NOT require that parser classes be annotated with @BuildParseTree in order to produce its trace files.

The tracer will collect all tracing elements (the input text, list of matchers and parsing nodes) into a zip file. This application will load such a zip file and will offer you several means of analyzing the parsing process.

It uses an H2 database as a SQL backend and JooQ to query this backend.

For more details, see this wiki page.

Future plans include:

• running a live debugging session of a parsing run;
• decompiling generated parsers.