Tristan Matthews | 0a329cc | 2013-07-17 13:20:14 -0400 | [diff] [blame] | 1 | |
| 2 | PJSIP CDASH AUTOMATED TESTS |
| 3 | -------------------------------- |
| 4 | |
| 5 | |
| 6 | 1. What is this |
| 7 | |
| 8 | This directory contains the scripts to run the automated, Python based tests |
| 9 | of PJSIP source codes, across platforms, and submit the test results to a CDash |
| 10 | test monitoring dashboard. |
| 11 | |
| 12 | Stuffs that are included in the test scope: |
| 13 | - configure (for GNU platforms, e.g. Linux, msys, and MacOS X) |
| 14 | - build |
| 15 | - standard unit tests (pjlib-test, pjsip-test, etc.) |
| 16 | - pjsua's Python based blackbox tests |
| 17 | |
| 18 | |
| 19 | 2. Requirements |
| 20 | |
| 21 | To run this test, you will need: |
| 22 | - Python (2.4 or later) |
| 23 | - curl (http://curl.haxx.se) |
| 24 | - a CDash server to receive test submissions (http://www.cdash.org) |
| 25 | - ccdash to submit the tests (http://trac.pjsip.org/ccdash) |
| 26 | |
| 27 | |
| 28 | 3. Configuration |
| 29 | |
| 30 | Create a Python configuration file by copying from "cfg_site_sample.py". |
| 31 | Save it as "cfg_site.py". You may create more than one configurations for your |
| 32 | site and save them as different files. |
| 33 | |
| 34 | |
| 35 | 4. Running |
| 36 | |
| 37 | To execute tests for GNU based targets: |
| 38 | |
| 39 | $ python main.py cfg_gnu |
| 40 | |
| 41 | |
| 42 | To execute tests for MSVC based target: |
| 43 | |
| 44 | $ python main.py cfg_msvc |
| 45 | |
| 46 | To execute tests for Symbian target: |
| 47 | |
| 48 | $ python main.py cfg_symbian |
| 49 | |
| 50 | |
| 51 | If you have a different site configuration file, you may specify it in the |
| 52 | arguments, e.g.: |
| 53 | |
| 54 | $ python main.py cfg_gnu my_site_config |
| 55 | |
| 56 | For more information you can also pass "-h" or "--help", e.g.: |
| 57 | |
| 58 | $ python main.py cfg_gnu --help |
| 59 | |