summaryrefslogtreecommitdiff
path: root/pjsip-apps/src/test-pjsua/README.TXT
blob: f21c79085e90588b1946b69c023e6aec49768ced (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

                           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 runall.py

To run individual test:
  $ python run.py MODULE CONFIG

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 configurations 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

  - mod_media_playrec.py:
  	Media testing

Example:
  $ python run.py mod_run.py scripts-run/100_simple.py
  $ python run.py mod_call.py scripts-call/100_simple.py