GGX-Toolbox

GGX-Toolbox is a small toolkit for different activities based on the GGX-file format. This format is produced by the graph transformation engine AGG which is developed at the Technical University of Berlin. AGG is working with attributed graphs, that are used in several S3 projects. GGX-Toolbox uses the AGG-API (Version 1.6.4) as an underlying engine for all graph transformation activities.

GGX-Toolbox mainly introduces two additional features:

Rule control scripts

AGG allows to execute transformation rules by sequence or organized on layers. Rule control scripts allow looping about layers or sequences of layers as well as branching. Branching decisions take into account whether rules on a certain layer have been applied or not. In addition, transformation options like the "dangling condition" can be switched on and off for each layer individually by rule control scripts.

Parsing and rewriting Java Syntax Graphs

Through an integrated parser (taken from Eclipse JDT) GGX-Toolbox can parse Java files and output their syntax tree as graph file. During parsing, references between types or methods are resolved and marked in the graph by additional edges. Transformations on a syntax graph are recorded and can be written back to the original source files, including moving files to new packages or generating and deleting files.

Standalone version

The standalone version of GGX-Toolbox is based on Eclipse RCP. The simple GUI allows to select Java files, graph files and control scripts for input and another graph file for output. Settings can be saved to file, so that different configurations for repetitive tasks can easily be managed.

Click here to download latest standalone version (2010-09-16) for windows (ZIP-file). The download is provided without any warranty!

Eclipse version

The Eclipse version of GGX-Toolbox offers a subset of functionallity as Eclipse Plug-In. It adds context menu entries for generating GGX-files out of source files and write source files from graphs. This version does not allow customized tasks or the use of control scripts. Provinding extension points for adding customized tasks as additional menu entries is planned for future releases.

Click here to download latest Eclipse version (2010-09-16 / ZIP-file). The download is provided without any warranty!

Resources

• User guide (not yet available)
• java_typegraph.ggx (2010-09-03) - The type graph used when parsing Java files. May not cover full Java6 and may thus be updated in future.
• An example project for the standalone version.

Publications

• Michael Striewe, Moritz Balz, Michael Goedicke: Enabling Graph Transformations on Program Code, in: Juan de Lara and Daniel Varro (Eds.): Preproceedings of the 4th International Workshop on Graph Based Tools, Enschede, The Netherlands, 2010, CTIT Workshop Proceedings WP 2010-06, ISSN 0929-0672

Contact

For more information regarding GGX-Toolbox please contact Michael Striewe. GGX-Toolbox is development work and so any bug reports are appreciated.