Boost Testing :
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2007-10-15 11:51:27
I just checked in the changes to the regression.py script(s) to allow
easier testing of any branch. Along with them I did some minor file
rearrangement. But with all the changes the old version of regression.py
is still alive in the usual location. Such that we don't interrupt
testing. Now for the new testing...
If you are interested in doing some testing with the new scripts there
is one requirement (currently): it only supports getting code from SVN.
This *might* change when we can get the tarball working again, but I
didn't bother at the moment as it's impossible to test it :-( For now
here are some short docs on what to do, while I write up some longer docs:
* Create a new directory for the branch you want to test.
* Download the new run.py script
* Run the "python run.py [options] [commands]" as you would for
* To test trunk use "--tag=trunk" (the default), and to test the release
use "--tag=branches/release". Or substitute any Boost tree of your choice.
There are a few option and command changes in the rework but overall the
options are the same:
usage: run.py [options] [commands]
commands: cleanup, collect-logs, get-source, get-tools, patch,
regression, setup, show-revision, test, test-clean, test-process,
test-run, update-source, upload-logs
-h, --help show this help message and exit
--runner=RUNNER runner ID (e.g. 'Metacomm')
--comment=COMMENT an HTML comment file to be inserted in the
--tag=TAG the tag for the results
--toolsets=TOOLSETS comma-separated list of toolsets to test with
--incremental do incremental run (do not remove previous
--timeout=TIMEOUT specifies the timeout, in minutes, for a single
options to pass to the regression test
bootstrap toolset for 'bjam' executable
bootstrap toolset for 'process_jam_log'
--user=USER Boost SVN user ID
--local=LOCAL the name of the boost tarball
do an SVN update (if applicable) instead of a
clean checkout, even when performing a full run
do neither a tarball download nor an SVN update;
used primarily for testing script changes
--proxy=PROXY HTTP proxy server address and port
FTP proxy server (e.g. 'ftpproxy')
the dart server to send results to
debugging level; controls the amount of
debugging output printed
--send-bjam-log send full bjam log of the regression run
--mail=MAIL email address to send run notification to
STMP server address/login information, in the
do not run bjam; used for testing script changes
Note, the run.py script is strictly a bootstrap program. It will
download the current regression.py. Changes from older regression.py:
* We now default to using SVN, and until I can test with a working
tarball, it's required.
* It doesn't send bjam logs by default, and hence the option has changed
For those that run the individual commands:
* There's a new command "get-tools" which needs to run first. As it
downloads bjam, BB, and the rest of the regression tools.
* There's now separate sub-commands for "test", in case you want to get
more fine grained in your control. Using "test" calls them as needed.
And last, to set up your SVN client to access you proxy Noel mentioned
earlier what to set, but here's the expanded docs for that
-- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo