Apache > Gump
Apache Gump™
 

Apache Gump™

Getting Started

Note
Apache Python Gump shares the first few steps with Traditional Gump, so start here

Select your interface

Python Gump has two primary usage interfaces:

  • Graphic User Interface (human users)
    This leverages wxPython's wxWindows
  • Command Line (human and automatic users, e.g. cron)
    This provides the basics functions of existing gump (gen/update/build)

Graphical User Interface

SET PYTHONPATH=C:\gump\python
CD /d C:\gump\python
python gump\gui\view.py -w ..\myworkspace.xml
		
cd /gump/python
export PYTHONPATH=`pwd`
python gump/gui/view.py -w ../myworspace.xml
		

GUI Usage

If you select a project, you can walk the project dependencies in both directions, see what prereqs aren't installed, see the actual classpath and properties used in the ant builds, and see what jars a project produces. One pane initially shows the fully expanded XML project definition (implicit dependencies added, properties resolved, etc). You actually can run a build from this tool. A typical scenario is to select the project that you are interested in, check the prereqs and dependencies tabs. If a dependency failed, you can click on it to go to that project. Press the 'run' icon to build it. If it succeeds, press the 'back' button to return to the project you started with and repeat. More detailed information on what is being done can be found in the console window which you can access by pressing the console icon.

Command Line Tools:

SET PYTHONPATH=C:\gump\python
CD /d C:\gump\python
python gump\build.py -w ..\myworkspace.xml all
		
cd /gump/python
export PYTHONPATH=`pwd`
python gump/build.py -w ../myworkspace.xml all
		
Note
There are some similar tools w/ similar command line arguments:
update.py -- update project(s) from source control
build.py -- build project(s)
integrate.py -- does "the works" check/update/build/statistics/document/nag
Note
The command line arguments accept a regular expression that resolves over project names NOT module names. "all" is converted to the regular expression "*". This is a new feature in Python Gump, and a mild divergence from traditional gump usage. When (say) updating a "list of modules" the utilities calculate the modules containing the requests projects, and hence translates for the user.

by Sam Ruby