blob: bb1f8964cd43817c4fd3843f4004af0a7d078c82 (
plain) (
blame)
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
|
# Testing STASIS
## Unit tests
Rules:
* Use the boilerplate `_test_boilerplate.c`
* ```shell
cp _test_boilerplate.c test_mynewtest.c
```
* Test file names start with `test_` (`test_file.c`)
* Test functions start with `test_` (`void test_function()`)
* Test suites can be skipped by returning `127` from `main()`
* PASS, FAIL, and SKIP conditions are set by the assertion macros `STASIS_{ASSERT,ASSERT_FATAL,SKIP_IF}`
* Parametrized tests should implement an array of `struct testcase`
* The `testcase` structure should be local to each `test_` function
* The `testcase` variables are freeform
* Example:
```c
void test_function() {
struct testcase {
int your;
int variables;
int here;
};
struct testcase tc[] = {
{.your = 0, .variables = 1, .here = 2},
{.your = 3, .variables = 4, .here = 5},
// ...
};
for (size_t i = 0; i < sizeof(tc) / sizeof(*tc); i++) {
// STASIS_ASSERT()s here
}
}
```
## Regression test (RT)
Rules:
* Regression tests are shell scripts (BASH)
* Use the boilerplate `_rt_boilerplate.sh`
* ```shell
cp _rt_boilerplate.sh rt_mynewtest.sh
```
* Test file names start with `rt_` (`rt_file.sh`)
* Test function names are freeform, however they must be executed using `run_command()` (`run_command test_function`)
* Test suites can be skipped by returning `127` from the shell script
|
