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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
#ifndef TEST_COMMON_H
#define TEST_COMMON_H
struct istream *test_istream_create(const char *data);
struct istream *test_istream_create_data(const void *data, size_t size);
void test_istream_set_size(struct istream *input, uoff_t size);
void test_istream_set_allow_eof(struct istream *input, bool allow);
void test_istream_set_max_buffer_size(struct istream *input, size_t size);
struct ostream *test_ostream_create(buffer_t *output);
struct ostream *test_ostream_create_nonblocking(buffer_t *output,
size_t max_internal_buffer_size);
/* When output->used reaches max_size, start buffering output internally.
When internal buffer reaches max_internal_buffer_size, start returning 0 for
o_stream_send*(). */
void test_ostream_set_max_output_size(struct ostream *output, size_t max_size);
void test_begin(const char *name);
#define test_assert(code) STMT_START { \
if (!(code)) test_assert_failed(#code, __FILE__, __LINE__); \
} STMT_END
/* Additional parameter may be int or unsigned int, to indicate which of
* a barrage of tests have failed (such as in a loop).
*/
#define test_assert_idx(code, i) STMT_START { \
if (!(code)) test_assert_failed_idx(#code, __FILE__, __LINE__, i); \
} STMT_END
/* Additional parameters are s1 (source) and s2 (destination) string
* in strcmp().
*/
#define test_assert_strcmp(s1, s2) STMT_START { \
test_assert_strcmp_idx(s1, s2, LLONG_MIN); \
} STMT_END
/* Same as test_assert_strcmp expect that it takes an additional i as input.
* When i is greater than or equals 0 it is used to identify the barrage of
* tests failed like in test_assert_idx.
*/
#define test_assert_strcmp_idx(_s1, _s2, i) STMT_START { \
const char *_temp_s1 = (_s1); \
const char *_temp_s2 = (_s2); \
if ((null_strcmp(_temp_s1,_temp_s2) != 0)) \
test_assert_failed_strcmp_idx("strcmp(" #_s1 "," #_s2 ")", \
__FILE__, __LINE__, _temp_s1, _temp_s2, i); \
} STMT_END
#define test_assert_cmp(_value1, _op, _value2) \
test_assert_cmp_idx(_value1, _op, _value2, LLONG_MIN)
#define test_assert_cmp_idx(_value1, _op, _value2, _idx) STMT_START { \
intmax_t _temp_value1 = (_value1); \
intmax_t _temp_value2 = (_value2); \
if (!(_value1 _op _value2)) \
test_assert_failed_cmp_intmax_idx( \
#_value1 " " #_op " " #_value2, \
__FILE__, __LINE__, _temp_value1, _temp_value2, \
#_op, _idx); \
} STMT_END
#define test_assert_ucmp(_value1, _op, _value2) \
test_assert_ucmp_idx(_value1, _op, _value2, LLONG_MIN)
#define test_assert_ucmp_idx(_value1, _op, _value2, _idx) STMT_START { \
uintmax_t _temp_value1 = (_value1); \
uintmax_t _temp_value2 = (_value2); \
if (!(_value1 _op _value2)) \
test_assert_failed_ucmp_intmax_idx( \
#_value1 " " #_op " " #_value2, \
__FILE__, __LINE__, _temp_value1, _temp_value2, \
#_op, _idx); \
} STMT_END
#ifdef STATIC_CHECKER
# define ATTR_STATIC_CHECKER_NORETURN ATTR_NORETURN
#else
# define ATTR_STATIC_CHECKER_NORETURN
#endif
void test_assert_failed(const char *code, const char *file, unsigned int line)
ATTR_STATIC_CHECKER_NORETURN;
void test_assert_failed_idx(const char *code, const char *file, unsigned int line, long long i)
ATTR_STATIC_CHECKER_NORETURN;
void test_assert_failed_strcmp_idx(const char *code, const char *file, unsigned int line,
const char * src, const char * dst, long long i)
ATTR_STATIC_CHECKER_NORETURN;
void test_assert_failed_cmp_intmax_idx(const char *code, const char *file,
unsigned int line,
intmax_t src, intmax_t dst,
const char *op, long long i)
ATTR_STATIC_CHECKER_NORETURN;
void test_assert_failed_ucmp_intmax_idx(const char *code, const char *file,
unsigned int line,
uintmax_t src, uintmax_t dst,
const char *op, long long i)
ATTR_STATIC_CHECKER_NORETURN;
bool test_has_failed(void);
/* If you're testing nasty cases which you want to warn, surround the noisy op with these */
void test_expect_errors(unsigned int expected);
void test_expect_error_string(const char *substr); /* expect just 1 message matching the printf format */
void test_expect_error_string_n_times(const char *substr, unsigned int times); /* expect just n messages matching the printf format */
void test_expect_no_more_errors(void);
/* Note that test_expect_error{s,_string}() effectively begin with a check equivalent
to test_expect_no_more_errors(), so you don't need the latter explicitly if following
it with either of the former.*/
void test_end(void);
void test_out(const char *name, bool success);
void test_out_quiet(const char *name, bool success); /* only prints failures */
void test_out_reason(const char *name, bool success, const char *reason)
ATTR_NULL(3);
int test_run(void (*const test_functions[])(void)) ATTR_WARN_UNUSED_RESULT;
struct named_test {
const char *name;
void (*func)(void);
};
int test_run_named(const struct named_test tests[], const char *match) ATTR_WARN_UNUSED_RESULT;
#define TEST_DECL(x) void x(void);
#define TEST_NAMELESS(x) x, /* Were you to want to use the X trick but not name the tests */
#define TEST_NAMED(x) { .name = #x , .func = x },
enum fatal_test_state {
FATAL_TEST_FINISHED, /* no more test stages, don't call again */
FATAL_TEST_FAILURE, /* single stage has failed, continue */
FATAL_TEST_ABORT, /* something's gone horrifically wrong */
};
/* The fatal function is called first with stage=0. After each call the stage
is increased by 1. The idea is that each stage would be running an
individual test that is supposed to crash. The function is called until
FATAL_TEST_FINISHED or FATAL_TEST_ABORT is returned. */
typedef enum fatal_test_state test_fatal_func_t(unsigned int stage);
typedef void test_fatal_callback_t(void *context);
struct named_fatal {
const char *name;
test_fatal_func_t *func;
};
int test_run_with_fatals(void (*const test_functions[])(void),
test_fatal_func_t *const fatal_functions[]);
int test_run_named_with_fatals(const char *match, const struct named_test tests[],
const struct named_fatal fatals[]);
/* Require the Fatal/Panic string to match this or the fatal test fails. */
void test_expect_fatal_string(const char *substr);
/* Call the specified callback when a fatal is being triggered. This is mainly
intended to allow freeing memory so valgrind won't complain about memory
leaks. */
void test_fatal_set_callback(test_fatal_callback_t *callback, void *context);
#define test_fatal_set_callback(callback, context) \
test_fatal_set_callback(1 ? (test_fatal_callback_t *)callback : \
CALLBACK_TYPECHECK(callback, void (*)(typeof(context))), \
context)
#define FATAL_DECL(x) enum fatal_test_state x(unsigned int);
#define FATAL_NAMELESS(x) x, /* Were you to want to use the X trick but not name the tests */
#define FATAL_NAMED(x) { .name = #x , .func = x },
/* If a child is forked within test context, but wants to operate outside it,
then this will avoid valgrind leak errors */
void test_forked_end(void);
/* If a fork() wants to exit(), then this will avoid valgrind leak errors */
void test_exit(int status) ATTR_NORETURN;
#endif
|
