Integration with Kitware CDash

CDash is a web-based testing dashboard showing configuration results, build results, and test results. It integrates naturally with CMake and CTest.

The test results produced by vvtest can be submitted to a CDash server using the --cdash SPECS command line option. For example, using either of these

$ vvtest --cdash "http://www.myorg-cdash.com,project=MyProj"
$ vvtest --cdash "https://www.myorg-cdash.com/foo/submit.php,project=MyProj"

will run all the tests followed by an http/https submission to the given server and URL. The CDash server will place the test results into the CDash project named "MyProj".

In general, the CDash specification string SPECS must start with a file name or a web URL, and is followed by a comma separated list of name=value attributes. The possible attributes are

• project : the CDash project name
• group : the name of the dashboard group to place the results line
• site : the site name of the results line
• name : the build name of the results line
• date : the date of the results line in seconds since epoch
• files : a value of "all" means include output files for all tests, and a value of "nonpass" (the default) only outputs files for non-passing tests
• filemax : output files have their middle removed if over a max size; the default is 100KB, but can be changed to values like 500KB, 10MB, and 1GB
• method : if method=curl, then the curl program will be used to upload the file; the default is method=urllib, which is an internal Python library; options to curl can be given, such as "method=curl -v" and "method=curl -v -k"

The project can alternatively be specified using the --cdash-project NAME option, and the date with the --results-date NUMBER option.

Note that a CDash submission can be done after the testing completes, by rerunning vvtest with the -i option:

$ vvtest
$ vvtest -i --cdash "http://www.myorg-cdash.com,project=MyProj,group=Product Platforms"