Gumbie --- Documentation

You may enjoy looking at a motivating example. An example illustrating all the features of the GUI description format is also available.

In order to get started with Gumbie, you can simply go to the Gumbie directory, type jython gengui.py, and open the file example.dat. This example file contains lots of comments, and you create a Jython program from your input by clicking on 'Generate Jython code'. This will take you to a new layer containing the newly generated Jython code, and you can try it by clicking on 'Run Jython code'.

If you prefer command line software, you can run the package by typing jython generator.py < example.dat > spam.py at the command line. The file spam.py is a Jython program that realizes the GUI defined in example.dat, and you can try it by typing jython spam.py.

The package is heavily documented, and you may want to study the code, beginning with MenuMaker.py, then PowerFrame.py and maybe LayeredFrame.py.

You may also find the following (more abstract) documents helpful:

The complete online documentation of each module, generated with HappyDoc, is available here.

Incidentally, most of gengui.py was generated by generator.py, and only about 10% of the program was written by hand. Essentially, I only had to implement callback functions for generating and launching Jython code.

If you would like to see a rather complex GUI implemented with Gumbie, then you can check out my train track software. The file pbjplus.jar contains the source code.

If you have any questions or comments, please let me know.


Peter Brinkmann
$Date: 2001-08-18 23:39:35-05 $

Valid HTML 4.01!