summaryrefslogtreecommitdiff
path: root/tests/cdash/README.TXT
blob: 69728b739fe480d7f6b9e46fcbc687a17d2aaa5e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
                                
                           PJSIP CDASH AUTOMATED TESTS
                        --------------------------------


1. What is this

   This directory contains the scripts to run the automated, Python based tests
of PJSIP source codes, across platforms, and submit the test results to a CDash
test monitoring dashboard.

   Stuffs that are included in the test scope:
    - configure (for GNU platforms, e.g. Linux, msys, and MacOS X)
    - build
    - standard unit tests (pjlib-test, pjsip-test, etc.)
    - pjsua's Python based blackbox tests


2. Requirements

   To run this test, you will need:
    - Python (2.4 or later)
    - curl (http://curl.haxx.se)
    - a CDash server to receive test submissions (http://www.cdash.org)
    - ccdash to submit the tests (http://trac.pjsip.org/ccdash)


3. Configuration

   Create a Python configuration file by copying from "cfg_site_sample.py". 
Save it as "cfg_site.py". You may create more than one configurations for your
site and save them as different files.


4. Running

   To execute tests for GNU based targets:

     $ python main.py cfg_gnu


   To execute tests for MSVC based target:

     $ python main.py cfg_msvc

   To execute tests for Symbian target:

     $ python main.py cfg_symbian


   If you have a different site configuration file, you may specify it in the
arguments, e.g.:

     $ python main.py cfg_gnu my_site_config

   For more information you can also pass "-h" or "--help", e.g.:

     $ python main.py cfg_gnu --help