66 lines
1.8 KiB
Text
66 lines
1.8 KiB
Text
|
|
||
|
|
PJSUA TEST FRAMEWORK
|
||
|
|
=========================
|
||
|
|
|
||
|
|
0. What is this
|
||
|
|
---------------
|
||
|
|
This is the automated testing scripts for pjsua. It can do many things (just
|
||
|
|
don't ask it to write good documentation :) ).
|
||
|
|
|
||
|
|
|
||
|
|
1. Requirements
|
||
|
|
---------------
|
||
|
|
To run the tests you need:
|
||
|
|
- Python (tested with Python 2.5.2)
|
||
|
|
- pjsua application, built and placed in pjsip-apps/bin directory
|
||
|
|
- the pjsua must be built with:
|
||
|
|
- SRTP enabled (the default)
|
||
|
|
|
||
|
|
|
||
|
|
2. Using
|
||
|
|
--------
|
||
|
|
To run all the tests:
|
||
|
|
$ python [OPTIONS] runall.py
|
||
|
|
|
||
|
|
To run individual test:
|
||
|
|
$ python [OPTIONS] run.py MODULE CONFIG
|
||
|
|
|
||
|
|
Where options:
|
||
|
|
-e EXE use EXE as pjsua executable
|
||
|
|
-n use null audio
|
||
|
|
-r TEST (for runall.py only) resume test at TEST
|
||
|
|
|
||
|
|
|
||
|
|
For each individual tests, the run.py is the main entry for the test. It
|
||
|
|
imports the various inc_xxx.py files, and it will load the MODULE. The MODULE
|
||
|
|
contains specific test flows, and we have few of them:
|
||
|
|
|
||
|
|
- mod_run.py:
|
||
|
|
a simple test which just run pjsua with the configuration from CONFIG
|
||
|
|
file and checks if pjsua can start properly.
|
||
|
|
|
||
|
|
- mod_call.py:
|
||
|
|
call testing where it spawns two pjsua instances each with configura-
|
||
|
|
tions as specified in CONFIG file, makes one pjsua call the other, and
|
||
|
|
checks if the call can be established.
|
||
|
|
|
||
|
|
- mod_pres.py:
|
||
|
|
presence testing
|
||
|
|
|
||
|
|
- mod_sendto.py:
|
||
|
|
Simple UAC to send arbitrary SIP message to pjsua. Good to test
|
||
|
|
various incoming INVITE scenarios
|
||
|
|
|
||
|
|
- mod_media_playrec.py:
|
||
|
|
Mainly for resampling quality testing
|
||
|
|
|
||
|
|
- mod_pesq.py
|
||
|
|
Measure call quality of various call settings with PESQ, for people
|
||
|
|
who have PESQ tool and license
|
||
|
|
|
||
|
|
Example:
|
||
|
|
$ python run.py mod_run.py scripts-run/100_simple.py
|
||
|
|
$ python run.py mod_call.py scripts-call/100_simple.py
|
||
|
|
|
||
|
|
|