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