— C-Unit Types: autounit_suite_t

This type holds summary information about a suite, pointers to setup and teardown functions and a list of autounit_test_t structures.

— C-Unit Types: autounit_test_fp_t

A typedef pointer to a function that excutes a test.

— C-Unit Types: autounit_test_t

This type holds information about a test and a pointer to code to be excecuted. It is normally "contained" by a autounit_suite_t.

— C-Unit Types: autounit_test_setup_fp_t

A pointer to a setup function called before each test. This function usually creates datastructures for the test functions to play with.

— C-Unit Types: autounit_test_teardown_fp_t

A pointer to a teardown function called after each test. This function usually frees datastructures created by the setup function.

— C-Unit Types: autounit_stress_report_t

This struct holds configuration information for how often to print "(test round)...." status during a stress test.

— C-Unit Macros: au_assert (test,err_msg,expression)

au_assert evaluates expression, when expression is false, err_msg is appended to the status for test. When expression is true, no changes are made to test. One should be wary of side-effects when writing expression.

          au_assert(t,"string not what we expected",strcmp(str,"hello")==0);
     

— C-Unit Functions: autounit_suite_t * au_new_suite (GString *name, autounit_test_setup_fp_t setup_fp, autounit_test_teardown_fp_t teardown_fp)

au_new_suite allocates a autounit_suite_t structure and initializes it with name and setup_fp and teardown_fp.

          autounit_suite_t *c_unit_test_suite = au_new_suite(g_string_new("Autounit C Unit Self Test"),
                  cus_setup_suite,cus_teardown_suite);
     

— C-Unit Functions: autounit_test_t * au_new_test (GString *name, autounit_test_fp_t test_fp)

au_new_test allocates a autounit_test_t structure and initializes it with name and test_fp.

After tests are created, the developer should use au_add_test to install into a suite. Unless the developer uses au_test_ref the test will be freed when removed from a suite or when the suite is deleted.

          autounit_test_t *tmp_test = au_new_test("test name", test_another_feature);
     

— C-Unit Functions: autounit_suite_t * au_add_test (autounit_suite_t *tc, autounit_test_t *test)

The pointer to the suite that was added to is returned and is the same as the suite given.

          au_add_test(c_unit_test_suite,tmp_test);
     

— C-Unit Functions: gint au_run_suite (autounit_suite_t *tc)

au_run_suite iterates through it's list of tests calling the setup fuction before the test code and then the teardown function.

          result = au_run_suite(c_unit_test_suite);
     

— C-Unit Functions: gint au_run_stress_suite (autounit_suite_t *tc, gint rounds, gint modulo)

au_run_stress_suite iterates through it's list of tests rounds times printing feedback every modulo rounds.

          result = au_run_stress_suite(c_unit_stresstest_suite,25,5);