#include "SDL_config.h"
#include "SDL_test.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>

Functions
float	GetClock ()

void	SDLTest_BailOut ()
	Timeout handler. Aborts test run and exits harness process. More...

Uint64	SDLTest_GenerateExecKey (char runSeed, char suiteName, char *testName, int iteration)

char *	SDLTest_GenerateRunSeed (const int length)

void	SDLTest_LogTestSuiteSummary (SDLTest_TestSuiteReference *testSuites)

int	SDLTest_RunSuites (SDLTest_TestSuiteReference testSuites[], const char userRunSeed, Uint64 userExecKey, const char *filter, int testIterations)
	Execute a test suite using the given run seend and execution key. More...

int	SDLTest_RunTest (SDLTest_TestSuiteReference testSuite, SDLTest_TestCaseReference testCase, Uint64 execKey)
	Execute a test using the given execution key. More...

SDL_TimerID	SDLTest_SetTestTimeout (int timeout, void(*callback)())
	Set timeout handler for test. More...

Variables
const char *	SDLTest_FinalResultFormat = ">>> %s '%s': %s\n"

const char *	SDLTest_InvalidNameFormat = "(Invalid)"

const char *	SDLTest_LogSummaryFormat = "%s Summary: Total=%d Passed=%d Failed=%d Skipped=%d"

static Uint32	SDLTest_TestCaseTimeout = 3600

Function Documentation

float GetClock ( )

Definition at line 343 of file SDL_test_harness.c.

Referenced by SDLTest_RunSuites().

void SDLTest_BailOut ( )

Timeout handler. Aborts test run and exits harness process.

Definition at line 208 of file SDL_test_harness.c.

References SDLTest_LogError(), and TEST_ABORTED.

Referenced by SDLTest_RunTest().

Uint64 SDLTest_GenerateExecKey	(	char *	runSeed,
		char *	suiteName,
		char *	testName,
		int	iteration
	)

Generates an execution key for the fuzzer.

Parameters

runSeed	The run seed to use
suiteName	The name of the test suite
testName	The name of the test
iteration	The iteration count

Returns: The generated execution key to initialize the fuzzer with.

Definition at line 100 of file SDL_test_harness.c.

References SDLTest_Md5Context::digest, NULL, SDL_free(), SDL_malloc(), SDL_memset(), SDL_snprintf(), SDL_strlen(), SDLTest_LogError(), SDLTest_Md5Final(), SDLTest_Md5Init(), and SDLTest_Md5Update().

Referenced by SDLTest_RunSuites().

char* SDLTest_GenerateRunSeed ( const int length )

Generates a random run seed string for the harness. The generated seed will contain alphanumeric characters (0-9A-Z).

Note: The returned string needs to be deallocated by the caller.

Parameters

length The length of the seed string to generate

Returns: The generated seed string

Definition at line 54 of file SDL_test_harness.c.

References NULL, SDL_malloc(), SDLTest_LogError(), SDLTest_Random(), and SDLTest_RandomInitTime().

Referenced by SDLTest_RunSuites().

void SDLTest_LogTestSuiteSummary ( SDLTest_TestSuiteReference * testSuites )

Definition at line 314 of file SDL_test_harness.c.

References SDLTest_TestCaseReference::description, SDLTest_TestCaseReference::name, SDLTest_TestSuiteReference::name, SDLTest_InvalidNameFormat, SDLTest_Log(), and SDLTest_TestSuiteReference::testCases.

int SDLTest_RunSuites	(	SDLTest_TestSuiteReference *	testSuites[],
		const char *	userRunSeed,
		Uint64	userExecKey,
		const char *	filter,
		int	testIterations
	)

Execute a test suite using the given run seend and execution key.

Execute a test suite using the given run seed and execution key.

The filter string is matched to the suite name (full comparison) to select a single suite, or if no suite matches, it is matched to the test names (full comparison) to select a single test.

Parameters

testSuites	Suites containing the test case.
userRunSeed	Custom run seed provided by user, or NULL to autogenerate one.
userExecKey	Custom execution key provided by user, or 0 to autogenerate one.
filter	Filter specification. NULL disables. Case sensitive.
testIterations	Number of iterations to run each test case.