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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
PureUnity
Copyright 2006 by Mathieu Bouchard <matju à artengine point ca>
$Id: README,v 1.3 2005-12-29 23:04:27 matju Exp $
+-+-+--+---+-----+--------+-------------+---------------------+
GOALS
1. To provide a unit-test framework, which also provide benchmarking features,
all made in Pd for use in Pd.
2. To provide tests for functionality in internals, externals, abstractions,
etc., in a modularized way, in a DRY/OAOO fashion, thus abstracting out
common features so that many objects share the same test patch for the
features that they have in common.
+-+-+--+---+-----+--------+-------------+---------------------+
TEST PROTOCOL
new:
create common (reusable) fixtures.
inlet 0:
bang:
run all available tests in that class. individual tests don't have
to be available through individual methods but may. If they do, the
names of the methods must match those given in the test results.
each test should build its own non-reusable fixtures and reinitialize
common fixtures, not assuming that the previous tests have left the
common fixtures in a normal state.
outlet 0:
test results. a sequence of lists like:
list $name $passed? $accuracy $elapsed
for example:
list
where:
$name is a symbol
$passed? is either 0 for failure or 1 for success
$accuracy is a float proportional to relative error on math
(if not applicable, use 0)
$elapsed is a float, the time elapsed in milliseconds
or it is the symbol "-" if not measured.
+-+-+--+---+-----+--------+-------------+---------------------+
SEVERITIES (in decreasing order)
* crash: Segmentation Fault, Bus Error, Illegal Instruction, Infinite Loop,
etc. You can't deal with those errors at the level of the tests. Maybe there
should be a way to tell a test object to skip certain tests, by name, in
order to be able to perform as many tests as possible while waiting for a
fix. It could become possible to rescue from some of those crashes if Pd
supported exceptions (stack-unwinding).
* corruption: this may cause future crashes and failures on innocent
objects/features. I have no solution for this except to be careful.
* post(),error(),pd_error(): Gets printed in the console. The problem is that
those can't be handled by the test objects, so someone has to read them and
interpret them. Also they prevent test objects to ensure that error
conditions produce error messages.
* pd_error2(): I wish this would exist. It would be sort of like pd_error()
but it would produce a pd message instead, whose selector would be an
error code, designed to be both localizable and [route]able. By default, that
message would be sent to the console, but there would be an internal class
designed to catch those messages. (If stack-unwinding were possible, it would
be disabled by default on pd_error2 and could be enabled explicitly
by-selector).
* failure: a test object reports a problem through outlet 0.
* dropout: a failure in realtimeness... difficult for an object to detect.
* inaccuracy: a test more or less succeeds but the test detected that the
epsilon sucks.
+-+-+--+---+-----+--------+-------------+---------------------+
PROTOCOL FOR [error]
new:
optional argument which would either be a float
(e.g. the $0 of the enclosing abstraction) or a pointer.
inlet 0:
set $scapegoat:
replaces the originator of the message by $scapegoat, which can be a
float or a pointer
error $1 ...:
causes its arguments to be concatenated, space-separated (may include
floats), and then sent through pd_error using the appropriate
originator (scapegoat).
list $1 ...:
for future use. would use pd_error2() (see README or previous mail).
$1 has to be a symbol.
+-+-+--+---+-----+--------+-------------+---------------------+
ETC
(write me!)
If +-test.pd tests [+], it can test for hotness, coldness, it can test
that only one result is produced per hot message, that all results are
float, that a few example additions work, and that with random inputs it
respects commutativity, associativity, invertibility, within appropriate
relative-error bounds, etc.
However +-test.pd can't test that errormessages aren't printed during the
testing. This may be something that we want to check for, and currently
the best way to handle it is to search the console for error messages, and
if there are any, restart the tests in verbose mode and see where the
error happens exactly.
|
