contrib/README.txt

   1 Utility scripts, things contributed by users but not strictly a part of
   2 buildbot:
   3
   4 debugclient.py (and debug.*): debugging gui for buildbot
   5
   6 fakechange.py: connect to a running bb and submit a fake change to trigger
   7                builders
   8
   9 generate_changelog.py: generated changelog entry using git. Requires git to
  10                        be installed.
  11
  12 run_maxq.py: a builder-helper for running maxq under buildbot
  13
  14 svn_buildbot.py: a script intended to be run from a subversion hook-script
  15                  which submits changes to svn (requires python 2.3)
  16
  17 svnpoller.py: this script is intended to be run from a cronjob, and uses 'svn
  18               log' to poll a (possibly remote) SVN repository for changes.
  19               For each change it finds, it runs 'buildbot sendchange' to
  20               deliver them to a waiting PBChangeSource on a (possibly remote)
  21               buildmaster. Modify the svnurl to point at your own SVN
  22               repository, and of course the user running the script must have
  23               read permissions to that repository. It keeps track of the last
  24               revision in a file, change 'fname' to set the location of this
  25               state file. Modify the --master argument to the 'buildbot
  26               sendchange' command to point at your buildmaster. Contributed
  27               by John Pye. Note that if there are multiple changes within a
  28               single polling interval, this will miss all but the last one.
  29
  30 svn_watcher.py: adapted from svnpoller.py by Niklaus Giger to add options and
  31                 run under windows. Runs as a standalone script (it loops
  32                 internally rather than expecting to run from a cronjob),
  33                 polls an SVN repository every 10 minutes. It expects the
  34                 svnurl and buildmaster location as command-line arguments.
  35
  36 viewcvspoll.py: a standalone script which loops every 60 seconds and polls a
  37                 (local?) MySQL database (presumably maintained by ViewCVS?)
  38                 for information about new CVS changes, then delivers them
  39                 over PB to a remote buildmaster's PBChangeSource. Contributed
  40                 by Stephen Kennedy.
  41
  42 CSS/*.css: alternative HTML stylesheets to make the Waterfall display look
  43            prettier. Copy them somewhere, then pass the filename to the
  44            css= argument of the Waterfall() constructor.