72704c5c100bc325784b243f4ce5c23e7a65f26f
[platform/upstream/gstreamer.git] / docs / random / testing / syntax
1 The test program
2 ----------------
3
4 We need a test program that:
5
6   - can read a file with the test specs
7   - construct a pipeline using the pipeline definition in the spec file
8     (using gst_parse_launch ())
9   - add signals to elements in the pipeline 
10   - run the pipeline for a fixed (in time/number of iterations) period
11   - record the fireing of the signals
12   - compare the signals to the expected results.
13
14
15 spec file contents:
16 -------------------
17
18 tcN: name-of-the-tescase
19 tcP: pipeline of the testcase in gst_parse_launch () syntax.
20 tcS: id1, element, signalname (attach to signal in an element)
21 tcS: id2, element, signalname
22 ...
23 tcI: the number of iterations on the top bin 
24 tcR: id1,1,id2,1,.. (the pattern of signals trigered)
25 or 
26 tcR: id1==id2,... (denote an equal number of signals)
27 /n
28
29
30 signal trigger patterns
31 -----------------------
32
33
34
35
36