Boost C++ Libraries

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