TestRun.c File Reference

---

Detailed Description

Test run management functions (implementation).

#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include <stdio.h>
#include <setjmp.h>
#include "CUnit.h"
#include "MyMem.h"
#include "TestDB.h"
#include "TestRun.h"
#include "test_cunit.h"

Data Structures
struct	TE
Typedefs
typedef enum TET	TestEventType
typedef TE	TestEvent
typedef TE *	pTestEvent
Enumerations
enum	TET { TEST_START = 1, TEST_COMPLETE, ALL_TESTS_COMPLETE, SUITE_INIT_FAILED }
Functions
void	clear_previous_results (CU_pRunSummary pRunSummary, CU_pFailureRecord *ppFailure)
	Initialize the run summary information in the specified structure.
void	cleanup_failure_list (CU_pFailureRecord *ppFailure)
	Free all memory allocated for the linked list of test failure records.
CU_ErrorCode	run_single_suite (CU_pSuite pSuite, CU_pRunSummary pRunSummary)
	Run all tests in a specified suite.
CU_ErrorCode	run_single_test (CU_pTest pTest, CU_pRunSummary pRunSummary)
	Run a specific test.
void	add_failure (CU_pFailureRecord *ppFailure, CU_pRunSummary pRunSummary, unsigned int uiLineNumber, char szCondition[], char szFileName[], CU_pSuite pSuite, CU_pTest pTest)
	Record a failed test.
void	add_test_event (TestEventType type, CU_pSuite psuite, CU_pTest ptest, CU_pFailureRecord pfailure)
void	clear_test_events (void)
void	test_start_handler (const CU_pTest pTest, const CU_pSuite pSuite)
void	test_complete_handler (const CU_pTest pTest, const CU_pSuite pSuite, const CU_pFailureRecord pFailure)
void	test_all_complete_handler (const CU_pFailureRecord pFailure)
void	suite_init_failure_handler (const CU_pSuite pSuite)
void	test_succeed (void)
void	test_fail (void)
int	suite_fail (void)
void	test_message_handlers (void)
void	test_exit (int status)
void	test_CU_run_all_tests (void)
void	test_CU_run_suite (void)
void	test_CU_run_test (void)
void	test_CU_get_number_of_suites_run (void)
void	test_CU_get_number_of_suites_failed (void)
void	test_CU_get_number_of_tests_run (void)
void	test_CU_get_number_of_tests_failed (void)
void	test_CU_get_number_of_asserts (void)
void	test_CU_get_number_of_successes (void)
void	test_CU_get_number_of_failures (void)
void	test_CU_get_failure_list (void)
void	test_CU_get_run_summary (void)
void	test_CU_get_current_suite (void)
void	test_CU_get_current_test (void)
void	test_CU_is_test_running (void)
void	test_CU_assertImplementation (void)
void	test_CU_clear_previous_results (void)
void	test_clear_previous_results (void)
void	test_cleanup_failure_list (void)
void	test_run_single_suite (void)
void	test_run_single_test (void)
void	test_add_failure (void)
void	test_cunit_TestRun (void)
Variables
BOOL	f_bTestIsRunning = FALSE
	Flag for whether a test run is in progress.
CU_pSuite	f_pCurSuite = NULL
	Pointer to the suite currently being run.
CU_pTest	f_pCurTest = NULL
	Pointer to the test currently being run.
CU_RunSummary	f_run_summary = {0, 0, 0, 0, 0, 0, 0}
	CU_RunSummary to hold results of each test run.
CU_pFailureRecord	f_failure_list = NULL
	CU_pFailureRecord to hold head of failure record list of each test run.
CU_pFailureRecord	f_last_failure = NULL
	Keeps track of end of f_run_summary list for message handlers.
CU_TestStartMessageHandler	f_pTestStartMessageHandler = NULL
	Pointer to the function to be called before running a test.
CU_TestCompleteMessageHandler	f_pTestCompleteMessageHandler = NULL
	Pointer to the function to be called after running a test.
CU_AllTestsCompleteMessageHandler	f_pAllTestsCompleteMessageHandler = NULL
	Pointer to the function to be called when all tests have been run.
CU_SuiteInitFailureMessageHandler	f_pSuiteInitFailureMessageHandler = NULL
	Pointer to the function to be called if a suite initialization function returns an error.
int	f_nTestEvents = 0
pTestEvent	f_pFirstEvent = NULL
BOOL	f_exit_called = FALSE

---

Typedef Documentation

typedef struct TE * pTestEvent

typedef struct TE TestEvent

typedef enum TET TestEventType

---

Enumeration Type Documentation

enum TET

Enumeration values: TEST_START  TEST_COMPLETE  ALL_TESTS_COMPLETE  SUITE_INIT_FAILED

---

Function Documentation

void add_test_event (  TestEventType  type, CU_pSuite  psuite, CU_pTest  ptest, CU_pFailureRecord  pfailure )  [static]

void clear_test_events (  void   )  [static]

int suite_fail (  void   )

void suite_init_failure_handler (  const CU_pSuite  pSuite  )  [static]

void test_add_failure (  void   )  [static]

void test_all_complete_handler (  const CU_pFailureRecord  pFailure  )  [static]

void test_cleanup_failure_list (  void   )  [static]

void test_clear_previous_results (  void   )  [static]

void test_complete_handler (  const CU_pTest  pTest, const CU_pSuite  pSuite, const CU_pFailureRecord  pFailure )  [static]

void test_CU_assertImplementation (  void   )  [static]

void test_CU_clear_previous_results (  void   )  [static]

void test_CU_get_current_suite (  void   )  [static]

void test_CU_get_current_test (  void   )  [static]

void test_CU_get_failure_list (  void   )  [static]

void test_CU_get_number_of_asserts (  void   )  [static]

void test_CU_get_number_of_failures (  void   )  [static]

void test_CU_get_number_of_successes (  void   )  [static]

void test_CU_get_number_of_suites_failed (  void   )  [static]

void test_CU_get_number_of_suites_run (  void   )  [static]

void test_CU_get_number_of_tests_failed (  void   )  [static]

void test_CU_get_number_of_tests_run (  void   )  [static]

void test_CU_get_run_summary (  void   )  [static]

void test_CU_is_test_running (  void   )  [static]

void test_CU_run_all_tests (  void   )  [static]

void test_CU_run_suite (  void   )  [static]

void test_CU_run_test (  void   )  [static]

void test_exit (  int  status  )

void test_fail (  void   )

void test_message_handlers (  void   )  [static]

void test_run_single_suite (  void   )  [static]

void test_run_single_test (  void   )  [static]

void test_start_handler (  const CU_pTest  pTest, const CU_pSuite  pSuite )  [static]

void test_succeed (  void   )

---

Variable Documentation

BOOL f_exit_called = FALSE [static]

int f_nTestEvents = 0 [static]

pTestEvent f_pFirstEvent = NULL [static]

---