blob: c216dd3c0c73e7ce8392bbb75ca74b109e5f6a74 (
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
#ifndef _EZTESTER_H
#define _EZTESTER_H
#include <stddef.h>
#include <stdio.h>
// possible results of a test.
// error is always fatal
typedef enum { TEST_PASS, TEST_WARNING, TEST_FAIL, TEST_ERROR } eztester_status;
/* how eztester should behave when encountering a non passing test.
*
* EXIT_ON_WARNING implies EXIT_ON_FAIL
*/
typedef enum { EXIT_ON_WARNING, CONTINUE_ALL, EXIT_ON_FAIL } eztester_behavior;
// a single individual test to be ran
typedef eztester_status(eztester_runner)();
typedef struct {
eztester_runner *runner;
const char *name;
} eztester_test;
typedef struct {
eztester_test *tests;
size_t length;
size_t capacity;
} eztester_list;
// create a list with a given capacity
eztester_list *eztester_create_list(const size_t capacity);
/* add a test to a list.
* the same test can be registered multiple times.
* will resize the list as necessary
*/
void eztester_register(eztester_list *test_list, const eztester_test new_test);
// remove all tests from a list but do not free the list itself
void eztester_clear_list(eztester_list *test_list);
// clears a list and free's the list
void eztester_destroy_list(eztester_list *test_list);
// log info during a test
void eztester_log(const char *__restrict format, ...);
// run all tests with a list with a given behavior
void eztester_run(eztester_list *test_list, const eztester_behavior behavior);
/* Wrapper for `system` function
*
* if command is null return the availability of a shell (negated result of
* system's behavior)
*
* If command is not null return the exit status of the process
*/
int eztester_shell(const char *command);
// tests that always return an eztester_status
// always return pass
eztester_status eztester_always_pass_test();
// always return warning
eztester_status eztester_always_warn_test();
// always return fail
eztester_status eztester_always_fail_test();
// always return error
eztester_status eztester_always_error_test();
#endif
|
