-
-/**
- A structure which describes a collection of test cases.
-*/
-struct collection_st {
- const char *name;
- test_callback_fn *pre;
- test_callback_fn *post;
- struct test_st *tests;
-};
-
-
-/**
- Structure which houses the actual callers for the test cases contained in
- the collections.
-*/
-struct world_runner_st {
- test_callback_runner_fn *pre;
- test_callback_runner_fn *run;
- test_callback_runner_fn *post;
-};
-
-
-/**
- world_st is the structure which is passed to the test implementation to be filled.
- This must be implemented in order for the test framework to load the tests. We call
- get_world() in order to fill this structure.
-*/
-
-struct world_st {
- collection_st *collections;
-
- /* These methods are called outside of any collection call. */
- test_callback_create_fn *create;
- test_callback_fn *destroy;
-
- /* This is called a the beginning of any collection run. */
- test_callback_fn *collection_startup;
-
- /* This is called a the end of any collection run. */
- test_callback_fn *collection_shutdown;
-
- /* This is called a the beginning of any run. */
- test_callback_fn *run_startup;
-
- /* This called on a test if the test requires a flush call (the bool is from test_st) */
- test_callback_fn *flush;
-
- /**
- These are run before/after the test. If implemented. Their execution is not controlled
- by the test.
- */
- test_callback_fn *pre_run;
- test_callback_fn *post_run;
-
- /**
- If an error occurs during the test, this is called.
- */
- test_callback_error_fn *on_error;
-
- /**
- Runner represents the callers for the tests. If not implemented we will use
- a set of default implementations.
- */
- world_runner_st *runner;
-
- world_st() :
- collections(NULL),
- create(NULL),
- destroy(NULL),
- collection_startup(NULL),
- collection_shutdown(NULL),
- run_startup(NULL),
- flush(NULL),
- pre_run(NULL),
- post_run(NULL),
- on_error(NULL),
- runner(NULL)
- { }
-
- virtual ~world_st()
- { }
-
-private:
- world_st(const world_st&);
- world_st& operator=(const world_st&);
-};
-
-
-
-/**
- @note world_stats_st is a simple structure for tracking test successes.
-*/
-struct world_stats_st {
- int32_t collection_success;
- int32_t collection_skipped;
- int32_t collection_failed;
- int32_t collection_total;
-
- uint32_t success;
- uint32_t skipped;
- uint32_t failed;
- uint32_t total;
-
- world_stats_st() :
- collection_success(0),
- collection_skipped(0),
- collection_failed(0),
- collection_total(0),
- success(0),
- skipped(0),
- failed(0),
- total(0)
- { }
-};
-
-#define TEST_STRINGIFY(x) #x
-#define TEST_TOSTRING(x) TEST_STRINGIFY(x)
-#define TEST_AT __FILE__ ":" TEST_TOSTRING(__LINE__)
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* How we make all of this work :) */
-LIBTEST_API
-void get_world(world_st *world);
-
-LIBTEST_INTERNAL_API
-void create_core(void);
-
-/**
- @note Friendly print function for errors.
-*/
-LIBTEST_INTERNAL_API
-const char *test_strerror(test_return_t code);
-