Changes between Version 9 and Version 10 of WikiStart


Ignore:
Timestamp:
Mar 4, 2020 4:54:30 AM (5 months ago)
Author:
stefan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v9 v10  
    1 = Test Tools =
    2 
    3 The Test Tools project provides Python scripts to automatically:
    4 
    5  1. download
    6  1. configure
    7  1. build
    8  1. test
    9  1. install
    10  1. build binaries
    11 
    12 of COIN-OR projects.  If a failure is recognized, the scripts can send an e-mail to the corresponding project manager.
    13 
    14 The Test Tools project is managed by JP Fasano. Contributors are JP Fasano, Kipp Martin, and Stefan Vigerske.
    15 
    16 == Installation ==
    17 
    18 Currently stable version 0.1 of this project is available. To check this project out using svn execute the command:
    19 {{{
    20 svn co https://projects.coin-or.org/svn/TestTools/stable/0.1  COIN-TestTools
    21 }}}
    22 
    23 This will check out a set of Python scripts into the directory {{{COIN-TestTools}}}.
    24 
    25 == Usage of nightlyBuild ==
    26 
    27 First, a user need to specify some parameters, e.g., the directory where nightlyBuild checks out and builds project.
    28 
    29 Parameters for nightlyBuild are specified via two Python scripts:
    30 
    31  * {{{NBuserParametersDefault.py}}} contains default values of all parameters. It should not be modified by the user since it receives updates together with other nightlyBuild scripts.
    32  * {{{NBuserParameters.py}}} is the user specific parameter file. nightlyBuild reads this file after {{{NBuserParametersDefault.py}}}, so it should be used to overwrite default values.
    33 
    34 To setup parameters, the user should
    35 {{{
    36   cp NBuserParametersDefault.py NBuserParameters.py
    37   vi NBuserParameters.py
    38 }}}
    39 The nightlyBuild parameters are documented in NBuserParametersDefault.py.
    40 See also the INSTALL file for more information.
    41 
    42 The main script is '''nightlyBuild.py'''. Assuming Python is in your PATH variable you can invoke nightlyBuild by simply entering at the command line
    43 {{{
    44 python nightlyBuild.py
    45 }}}
    46 
    47 == What nightlyBuild does... ==
    48 
    49 For each supported COIN-OR project a set of build types can be specified.
    50 A '''build type''' is a tuple of information containing the
    51 
    52  * {{{SvnVersion}}}: which version from the repository to built (trunk, latestStable, latestRelease, stable/0.1, ...)?
    53  * {{{OptLevel}}}: should the code be build in optimized mode ("Default") or debugging mode ("Debug")
    54  * {{{ThirdParty}}}: should it be allowed to use third party codes
    55  * {{{SkipProjects}}}: a list of COIN-OR projects (from the externals) that should be skipped in the build
    56  * {{{AdditionalConfigOptions}}}: additional flags for the configure call
    57 
    58 For such a build type, nightlyBuild does
    59 
    60  1. '''Checkout''' the specified version from the svn repository (!https://projects.coin-or.org/svn/<project>/...).
    61  1. '''Download third party codes''' for which {{{get.XXX}}} scripts can be found.
    62  1. Assemble the parameter for the configure call.
    63  1. Call '''configure'''. If there is an error, send a failure report as e-mail and break.
    64  1. Call '''make'''. If there is an error, send a failure report as e-mail and break.
    65  1. If the project has a '''test program''', call make test. If there is an error, send a failure report as e-mail and break.
    66  1. If the project has '''unit tests''', call the unit tests. If there is an error, send a failure report as e-mail and break.
    67  1. Run '''make install''' which will put any libraries that are built into a '''lib''' directory, any executables into a '''bin''' directory and the necessary header files into an '''include''' directory. If there is an error, send a failure report as e-mail and break.
    68  1. If the user specifies BUILD_BINARIES = 1 then a '''zipped archive''' is created of the project libraries, binaries, and header files.
    69 
    70 There are also rules implemented to avoid the rebuild and test of a project if there has been no change in the code since the last build.
    71 
    72 The failure reports contain, next to information about the build type and the system, also the output to stdout and stderr and a config.log file if configure failed.
    73 
    74 The output of get.XXX scripts, configure, make, unittests to stdout and stderr is also stored in the build directories for later analysis (e.g., NBmake.stdout).
    75 
    76 See the INSTALL file for more information.
    77 
    78 == Where nightlyBuild is currently running... ==
    79 
    80 See the page NightlyBuildInAction for a list of systems where the nightlyBuild scripts are running.
     1= The project moved to https://github.com/coin-or-tools/TestTools =