/**
* @file tester.c
*
- * @brief Test module for automatic testing
+ * @brief Implementation of tester_t.
*
*/
*
*/
struct private_tester_t {
+
+ /**
+ * Public interface.
+ */
tester_t public;
/* Private functions */
+ /**
+ * Runs a specific test.
+ *
+ * @param tester associated tester object
+ * @param test_function test function to perform
+ * @param test_name name for the given test
+ */
void (*run_test) (tester_t *tester, void (*test_function) (tester_t * tester), char * test_name);
/* Private values */
+ /**
+ * Output is written into this file.
+ */
FILE* output;
+
+ /**
+ * Number of runned tests.
+ */
int tests_count;
+
+ /**
+ * Number of failed tests.
+ */
int failed_tests_count;
+
+ /**
+ * Number of failed asserts in curret test.
+ */
int failed_asserts_count;
+
+ /**
+ * TRUE if succeeded asserts should also be written to output.
+ */
bool display_succeeded_asserts;
+
+ /**
+ * Mutex to make this object thread-save.
+ */
pthread_mutex_t mutex;
};
-/*
- * Implementation of function perform_tests
+/**
+ * Implementation of tester_t.perform_tests.
*/
static status_t perform_tests(tester_t *tester,test_t **tests)
{
return SUCCESS;
}
-/*
- * Implementation of function perform_test
+/**
+ * Implementation of tester_t.perform_test.
*/
static status_t perform_test(tester_t *tester, test_t *test)
{
}
/**
- * Returns the difference of to timeval structs in microseconds
- *
- * @param end_time end time
- * @param start_time start time
+ * Returns the difference of to timeval structs in microseconds.
*
* @warning this function is also defined in the event queue
* in later improvements, this function can be added to a general
* class type!
*
+ * @param end_time end time
+ * @param start_time start time
+ *
+ * @TODO make object function or move to utils!
+ *
* @return difference in microseconds
*/
static long time_difference(struct timeval *end_time, struct timeval *start_time)
/**
- * Implementation of function run_test
+ * Implementation of private_tester_t.run_test.
*/
static void run_test(tester_t *tester, void (*test_function) (tester_t * tester), char * test_name)
{
/**
- * Implementation of function assert_true
+ * Implementation of tester_t.assert_true.
*/
static void assert_true(tester_t *tester, bool to_be_true,char * assert_name)
{
}
/**
- * Implementation of function assert_false
+ * Implementation of tester_t.assert_false.
*/
static void assert_false(tester_t *tester, bool to_be_false,char * assert_name)
{
}
/**
- * Implements the destroy function
+ * Implementation of tester_t.destroy.
*/
static status_t destroy(tester_t *tester)
{
return SUCCESS;
}
+/*
+ * Described in header.
+ */
tester_t *tester_create(FILE *output, bool display_succeeded_asserts)
{
private_tester_t *this = allocator_alloc_thing(private_tester_t);
/**
* @file tester.h
*
- * @brief Test module for automatic testing
+ * @brief Interface of tester_t.
*
*/
#include <types.h>
-
typedef struct test_t test_t;
typedef struct tester_t tester_t;
/**
- * @brief Specifies a test
+ * @brief Representing a specified test.
+ *
+ * @ingroup utils
*/
struct test_t {
+ /**
+ * Testfunction called for this test.
+ *
+ * @param tester associated tester_t object
+ */
void (*test_function) (tester_t * tester);
+ /**
+ * Name of the test.
+ */
char * test_name;
};
/**
- * @brief A tester object to perform tests with
+ * A tester class to perform tests.
+ *
+ * @ingroup utils
*/
struct tester_t {
/**
- * @brief Tests all testcases in array tests with specific tester object
+ * @brief Tests all testcases in array tests with specific tester_t object.
*
- * @param tester tester object
- * @param pointer to a array of test_t-pointers.
- * the last item has to be NULL.
- * @return SUCCESSFUL if succeeded, FAILED otherwise
+ * @param tester tester_t object
+ * @param tests pointer to an array of test_t-pointers.
+ * The last item has to be NULL.
+ * @return SUCCESS in any case
*/
status_t (*perform_tests) (tester_t *tester,test_t **tests);
/**
- * @brief run a specific test case
+ * @brief Run a specific test case.
*
- * @param this tester object
- * @param test pointer to a test_t object which will be performed
- * @param Name of the Test
+ * @param this tester_t object
+ * @param test pointer to a test_t object which will be performed
+ * @return SUCCESS in any case
*/
status_t (*perform_test) (tester_t *tester, test_t *test);
/**
- * @brief is called in a testcase to check a specific situation for TRUE
+ * Is called in a testcase to check a specific situation for TRUE.
*
- * Log-Values to the tester output are protected from multiple access
+ * Log-Values to the tester output are protected from multiple access.
*
- * @warning this function should only be called in a test_function
+ * @warning This function should only be called in a test_function.
*
- * @param this tester object
- * @param to_be_true assert which has to be TRUE
- * @param Name of the assertion
+ * @param this tester_t object
+ * @param to_be_true assert which has to be TRUE
+ * @param assert_name name of the assertion
*/
void (*assert_true) (tester_t *tester, bool to_be_true, char *assert_name);
/**
- * @brief is called in a testcase to check a specific situation for FALSE
+ * Is called in a testcase to check a specific situation for FALSE.
*
- * Log-Values to the tester output are protected from multiple access
+ * Log-Values to the tester output are protected from multiple access.
*
- * @warning this function should only be called in a test_function
+ * @warning This function should only be called in a test_function.
*
- * @param this tester object
- * @param to_be_false assert which has to be FALSE
- * @param Name of the assertion
+ * @param this tester_t object
+ * @param to_be_false assert which has to be FALSE
+ * @param assert_name name of the assertion
*/
void (*assert_false) (tester_t *tester, bool to_be_false, char *assert_name);
/**
- * @brief Destroys a tester object
+ * @brief Destroys a tester_t object
*
- * @param tester tester object
- * @return SUCCESSFUL if succeeded, FAILED otherwise
+ * @param tester tester_t object
+ * @return SUCCESS in any case
*/
status_t (*destroy) (tester_t *tester);
};
/**
- * @brief creates a tester object needed to perform tests
+ * @brief Creates a tester_t object used to perform tests with.
*
- * @param output test output is written to this output
+ * @param output test output is written to this output.
* @param display_succeeded_asserts has to be TRUE, if all asserts should be displayed,
- * else otherwise
+ * FALSE otherwise
*
- * @return tester object
+ * @return
+ * - tester_t object
+ * - NULL if out of ressources
+ *
+ * @ingroup utils
*/
tester_t *tester_create(FILE *output, bool display_succeeded_asserts);