| Running Boost Regression Tests

## Requirements

- Python 2.3 or later.
- Subversion 1.4 or later.
- At least 5 gigabytes of disk space per compiler to be tested.

## Step by step instructions

1. Create a new directory for the branch you want to test.
2. Download the run.py script into that directory.
3. Run "`python 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

      options:
         -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
                               reports
         --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
                               binaries)
         --timeout=TIMEOUT     specifies the timeout, in minutes, for a single
                               test run/compilation
         --bjam-options=BJAM_OPTIONS
                               options to pass to the regression test
         --bjam-toolset=BJAM_TOOLSET
                               bootstrap toolset for 'bjam' executable
         --pjl-toolset=PJL_TOOLSET
                               bootstrap toolset for 'process_jam_log'
                               executable
         --platform=PLATFORM
         --user=USER           Boost SVN user ID
         --local=LOCAL         the name of the boost tarball
         --force-update=FORCE_UPDATE
                               do an SVN update (if applicable) instead of a
                               clean checkout, even when performing a full run
         --have-source=HAVE_SOURCE
                               do neither a tarball download nor an SVN update;
                               used primarily for testing script changes
         --proxy=PROXY         HTTP proxy server address and port
                               (e.g.'http://www.someproxy.com:3128')
         --ftp-proxy=FTP_PROXY
                               FTP proxy server (e.g. 'ftpproxy')
         --dart-server=DART_SERVER
                               the dart server to send results to
         --debug-level=DEBUG_LEVEL
                               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
         --smtp-login=SMTP_LOGIN
                               STMP server address/login information, in the
                               following form:
                               <user>:<password>@<host>[:<port>]
         --skip-tests=SKIP_TESTS
                               do not run bjam; used for testing script changes

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.

© Copyright Rene Rivera, 2007
Distributed under the Boost Software License, Version 1.0. See www.boost.org/LICENSE_1_0.txt

Revised November 23, 2007