/*

Simple DirectMedia Layer

Copyright (C) 1997-2012 Sam Lantinga <slouken@libsdl.org>

This software is provided 'as-is', without any express or implied

warranty.  In no event will the authors be held liable for any damages

arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,

including commercial applications, and to alter it and redistribute it

freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not

claim that you wrote the original software. If you use this software

in a product, an acknowledgment in the product documentation would be

appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be

misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

*/

#include "SDL_config.h"

#include "SDL_test.h"

#include <stdio.h>

#include <stdlib.h>

#include <string.h>

#include <time.h>

/* Invalid test name/description message format */

const char *SDLTest_InvalidNameFormat = "(Invalid)";

/* Log summary message format */

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

/* Final result message format */

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

/*! \brief Timeout for single test case execution */

static Uint32 SDLTest_TestCaseTimeout = 3600;

/**

* 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.

*

* \param length The length of the seed string to generate

*

* \returns The generated seed string

*/

char *

SDLTest_GenerateRunSeed(const int length)

{

	char *seed = NULL;

	SDLTest_RandomContext randomContext;

	int counter;

	// Sanity check input

	if (length <= 0) {

		SDLTest_LogError("The length of the harness seed must be >0.");

		return NULL;

	}

	// Allocate output buffer

	seed = (char *)SDL_malloc((length + 1) * sizeof(char));

	if (seed == NULL) {

		SDLTest_LogError("SDL_malloc for run seed output buffer failed.");

		return NULL;

	}

	// Generate a random string of alphanumeric characters

	SDLTest_RandomInitTime(&randomContext);

	for (counter = 0; counter < length - 1; ++counter) {

		unsigned int number = SDLTest_Random(&randomContext);

		char ch = (char) (number % (91 - 48)) + 48;

		if (ch >= 58 && ch <= 64) {

			ch = 65;

		}

		seed[counter] = ch;

	}

	seed[counter] = '\0';

	return seed;

}

/**

* Generates an execution key for the fuzzer.

*

* \param runSeed		The run seed to use

* \param suiteName		The name of the test suite

* \param testName		The name of the test

* \param iteration		The iteration count

*

* \returns The generated execution key to initialize the fuzzer with.

*

*/

Uint64

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

{

	SDLTest_Md5Context md5Context;

	Uint64 *keys;

	char iterationString[16];

	Uint32 runSeedLength;

	Uint32 suiteNameLength;

	Uint32 testNameLength;

	Uint32 iterationStringLength;

	Uint32 entireStringLength;

	char *buffer;

	if (runSeed == NULL || SDL_strlen(runSeed)==0) {

		SDLTest_LogError("Invalid runSeed string.");

		return -1;

	}

	if (suiteName == NULL || SDL_strlen(suiteName)==0) {

		SDLTest_LogError("Invalid suiteName string.");

		return -1;

	}

	if (testName == NULL || SDL_strlen(testName)==0) {

		SDLTest_LogError("Invalid testName string.");

		return -1;

	}

	if (iteration <= 0) {

		SDLTest_LogError("Invalid iteration count.");

		return -1;

	}

	// Convert iteration number into a string

	SDL_memset(iterationString, 0, sizeof(iterationString));

	SDL_snprintf(iterationString, sizeof(iterationString) - 1, "%d", iteration);

	// Combine the parameters into single string

	runSeedLength = SDL_strlen(runSeed);

	suiteNameLength = SDL_strlen(suiteName);

	testNameLength = SDL_strlen(testName);

	iterationStringLength = SDL_strlen(iterationString);

	entireStringLength  = runSeedLength + suiteNameLength + testNameLength + iterationStringLength + 1;

	buffer = (char *)SDL_malloc(entireStringLength);

	if (buffer == NULL) {

		SDLTest_LogError("SDL_malloc failed to allocate buffer for execKey generation.");

		return 0;

	}

	SDL_snprintf(buffer, entireStringLength, "%s%s%s%d", runSeed, suiteName, testName, iteration);

	// Hash string and use half of the digest as 64bit exec key

	SDLTest_Md5Init(&md5Context);

	SDLTest_Md5Update(&md5Context, (unsigned char *)buffer, entireStringLength);

	SDLTest_Md5Final(&md5Context);

	SDL_free(buffer);

	keys = (Uint64 *)md5Context.digest;

	return keys[0];

}

/**

* \brief Set timeout handler for test.

*

* Note: SDL_Init(SDL_INIT_TIMER) will be called if it wasn't done so before.

*

* \param timeout Timeout interval in seconds.

* \param callback Function that will be called after timeout has elapsed.

* 

* \return Timer id or -1 on failure.

*/

SDL_TimerID

SDLTest_SetTestTimeout(int timeout, void (*callback)())

{

	Uint32 timeoutInMilliseconds;

	SDL_TimerID timerID;

	if (callback == NULL) {

		SDLTest_LogError("Timeout callback can't be NULL");

		return -1;

	}

	if (timeout < 0) {

		SDLTest_LogError("Timeout value must be bigger than zero.");

		return -1;

	}

	/* Init SDL timer if not initialized before */

	if (SDL_WasInit(SDL_INIT_TIMER) == 0) {

		if (SDL_InitSubSystem(SDL_INIT_TIMER)) {

			SDLTest_LogError("Failed to init timer subsystem: %s", SDL_GetError());

			return -1;

		}

	}

	/* Set timer */

	timeoutInMilliseconds = timeout * 1000;

	timerID = SDL_AddTimer(timeoutInMilliseconds, (SDL_TimerCallback)callback, 0x0);

	if (timerID == 0) {

		SDLTest_LogError("Creation of SDL timer failed: %s", SDL_GetError());

		return -1;

	}

	return timerID;

}

/**

* \brief Timeout handler. Aborts test run and exits harness process.

*/

void

	SDLTest_BailOut()

{

	SDLTest_LogError("TestCaseTimeout timer expired. Aborting test run.");

	exit(TEST_ABORTED); // bail out from the test

}

/**

* \brief Execute a test using the given execution key.

*

* \param testSuite Suite containing the test case.

* \param testCase Case to execute.

* \param execKey Execution key for the fuzzer.

*

* \returns Test case result.

*/

int

	SDLTest_RunTest(SDLTest_TestSuiteReference *testSuite, SDLTest_TestCaseReference *testCase, Uint64 execKey)

{

	SDL_TimerID timer = 0;

	int testResult = 0;

	int fuzzerCount;

	if (testSuite==NULL || testCase==NULL || testSuite->name==NULL || testCase->name==NULL)

	{

		SDLTest_LogError("Setup failure: testSuite or testCase references NULL");

		return TEST_RESULT_SETUP_FAILURE;

	}

	if (!testCase->enabled)

	{

		SDLTest_Log((char *)SDLTest_FinalResultFormat, "Test", testCase->name, "Skipped (Disabled)");

		return TEST_RESULT_SKIPPED;

	}

	// Initialize fuzzer

	SDLTest_FuzzerInit(execKey);

	// Reset assert tracker

	SDLTest_ResetAssertSummary();

	// Set timeout timer

	timer = SDLTest_SetTestTimeout(SDLTest_TestCaseTimeout, SDLTest_BailOut);

	// Maybe run suite initalizer function

	if (testSuite->testSetUp) {

		testSuite->testSetUp(0x0);

		if (SDLTest_AssertSummaryToTestResult() == TEST_RESULT_FAILED) {

			SDLTest_LogError((char *)SDLTest_FinalResultFormat, "Suite Setup", testSuite->name, "Failed");

			return TEST_RESULT_SETUP_FAILURE;

		}

	}

	// Run test case function

	testCase->testCase(0x0);

	testResult = SDLTest_AssertSummaryToTestResult();

	// Maybe run suite cleanup function (ignore failed asserts)

	if (testSuite->testTearDown) {

		testSuite->testTearDown(0x0);

	}

	// Cancel timeout timer

	if (timer) {

		SDL_RemoveTimer(timer);

	}

	// Report on asserts and fuzzer usage

	fuzzerCount = SDLTest_GetFuzzerInvocationCount();

	if (fuzzerCount > 0) {

		SDLTest_Log("Fuzzer invocations: %d", fuzzerCount);

	}

	SDLTest_LogAssertSummary();

	return testResult;

}

/* Prints summary of all suites/tests contained in the given reference */

void SDLTest_LogTestSuiteSummary(SDLTest_TestSuiteReference *testSuites)

{

	int suiteCounter;

	int testCounter;

	SDLTest_TestSuiteReference *testSuite;

	SDLTest_TestCaseReference *testCase;

	// Loop over all suites

	suiteCounter = 0;

	while(&testSuites[suiteCounter]) {

		testSuite=&testSuites[suiteCounter];

		suiteCounter++;

		SDLTest_Log("Test Suite %i - %s\n", suiteCounter, 

			(testSuite->name) ? testSuite->name : SDLTest_InvalidNameFormat);

		// Loop over all test cases

		testCounter = 0;

		while(testSuite->testCases[testCounter])

		{

			testCase=(SDLTest_TestCaseReference *)testSuite->testCases[testCounter];

			testCounter++;

			SDLTest_Log("  Test Case %i - %s: %s", testCounter, 

				(testCase->name) ? testCase->name : SDLTest_InvalidNameFormat, 

				(testCase->description) ? testCase->description : SDLTest_InvalidNameFormat);

		}

	}

}

/* Gets a timer value in seconds */

float GetClock()

{

	float currentClock = (float)clock();

	return currentClock / (float)CLOCKS_PER_SEC;

}

/**

* \brief Execute a test suite using the given run seend 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.

*

* \param testSuites Suites containing the test case.

* \param userRunSeed Custom run seed provided by user, or NULL to autogenerate one.

* \param userExecKey Custom execution key provided by user, or 0 to autogenerate one.

* \param filter Filter specification. NULL disables. Case sensitive.

* \param testIterations Number of iterations to run each test case.

*

* \returns Test run result; 0 when all tests passed, 1 if any tests failed.

*/

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

{

	int suiteCounter;

	int testCounter;

	int iterationCounter;

	SDLTest_TestSuiteReference *testSuite;

	SDLTest_TestCaseReference *testCase;

	const char *runSeed = NULL;

	char *currentSuiteName;

	char *currentTestName;

	Uint64 execKey;

	float runStartSeconds;

	float suiteStartSeconds;

	float testStartSeconds;

	float runEndSeconds;

	float suiteEndSeconds;

	float testEndSeconds;

	float runtime;

	int suiteFilter = 0;

	char *suiteFilterName = NULL;

	int testFilter = 0;

	char *testFilterName = NULL;

	int testResult = 0;

	int runResult = 0;

	Uint32 totalTestFailedCount = 0;

	Uint32 totalTestPassedCount = 0;

	Uint32 totalTestSkippedCount = 0;

	Uint32 testFailedCount = 0;

	Uint32 testPassedCount = 0;

	Uint32 testSkippedCount = 0;

	Uint32 countSum = 0;

	char *logFormat = (char *)SDLTest_LogSummaryFormat;

	// Sanitize test iterations

	if (testIterations < 1) {

		testIterations = 1;

	}

	// Generate run see if we don't have one already

	if (userRunSeed == NULL || SDL_strlen(userRunSeed) == 0) {

		runSeed = SDLTest_GenerateRunSeed(16);

		if (runSeed == NULL) {

			SDLTest_LogError("Generating a random seed failed");

			return 2;

		}

	} else {

		runSeed = userRunSeed;

	}

	// Reset per-run counters

	totalTestFailedCount = 0;

	totalTestPassedCount = 0;

	totalTestSkippedCount = 0;

	// Take time - run start

	runStartSeconds = GetClock();

	// Log run with fuzzer parameters

	SDLTest_Log("::::: Test Run /w seed '%s' started\n", runSeed);

	// Initialize filtering

	if (filter != NULL && SDL_strlen(filter) > 0) {

		/* Loop over all suites to check if we have a filter match */

		suiteCounter = 0;

		while (testSuites[suiteCounter] && suiteFilter == 0) {

			testSuite=(SDLTest_TestSuiteReference *)testSuites[suiteCounter];

			suiteCounter++;

			if (testSuite->name != NULL && SDL_strcmp(filter, testSuite->name) == 0) {

				/* Matched a suite name */

				suiteFilter = 1;

				suiteFilterName = testSuite->name;

				SDLTest_Log("Filtering: running only suite '%s'", suiteFilterName);

				break;

			}

			/* Within each suite, loop over all test cases to check if we have a filter match */

			testCounter = 0;

			while (testSuite->testCases[testCounter] && testFilter == 0)

			{

				testCase=(SDLTest_TestCaseReference *)testSuite->testCases[testCounter];

				testCounter++;

				if (testCase->name != NULL && SDL_strcmp(filter, testCase->name) == 0) {

					/* Matched a test name */

					suiteFilter = 1;

					suiteFilterName = testSuite->name;

					testFilter = 1;

					testFilterName = testCase->name;

					SDLTest_Log("Filtering: running only test '%s' in suite '%s'", testFilterName, suiteFilterName);					

					break;

				}

			}						

		}

		if (suiteFilter == 0 && testFilter == 0) {

			SDLTest_LogError("Filter '%s' did not match any test suite/case.", filter);

			SDLTest_Log("Exit code: 2");	

			return 2;

		}		

	}

	// Loop over all suites

	suiteCounter = 0;

	while(testSuites[suiteCounter]) {

		testSuite=(SDLTest_TestSuiteReference *)testSuites[suiteCounter];

		currentSuiteName = (char *)((testSuite->name) ? testSuite->name : SDLTest_InvalidNameFormat);

		suiteCounter++;

		// Filter suite if flag set and we have a name

		if (suiteFilter == 1 && suiteFilterName != NULL && testSuite->name != NULL &&

			SDL_strcmp(suiteFilterName, testSuite->name) != 0) {

				// Skip suite

				SDLTest_Log("===== Test Suite %i: '%s' skipped\n", 

					suiteCounter, 

					currentSuiteName);

		} else {

			// Reset per-suite counters

			testFailedCount = 0;

			testPassedCount = 0;

			testSkippedCount = 0;

			// Take time - suite start

			suiteStartSeconds = GetClock();

			// Log suite started

			SDLTest_Log("===== Test Suite %i: '%s' started\n", 

				suiteCounter, 

				currentSuiteName);

			// Loop over all test cases

			testCounter = 0;

			while(testSuite->testCases[testCounter])

			{

				testCase=(SDLTest_TestCaseReference *)testSuite->testCases[testCounter];

				currentTestName = (char *)((testCase->name) ? testCase->name : SDLTest_InvalidNameFormat);

				testCounter++;

				// Filter tests if flag set and we have a name

				if (testFilter == 1 && testFilterName != NULL && testCase->name != NULL &&

					SDL_strcmp(testFilterName, testCase->name) != 0) {

						// Skip test

						SDLTest_Log("===== Test Case %i.%i: '%s' skipped\n", 

							suiteCounter,

							testCounter,

							currentTestName);

				} else {

					// Take time - test start

					testStartSeconds = GetClock();

					// Log test started

					SDLTest_Log("----- Test Case %i.%i: '%s' started",

						suiteCounter,

						testCounter, 

						currentTestName);

					if (testCase->description != NULL && SDL_strlen(testCase->description)>0) {

						SDLTest_Log("Test Description: '%s'", 

							(testCase->description) ? testCase->description : SDLTest_InvalidNameFormat);

					}

					// Loop over all iterations

					iterationCounter = 0;

					while(iterationCounter < testIterations)

					{

						iterationCounter++;

						if (userExecKey != 0) {

							execKey = userExecKey;

						} else {

							execKey = SDLTest_GenerateExecKey((char *)runSeed, testSuite->name, testCase->name, iterationCounter);

						}

						SDLTest_Log("Test Iteration %i: execKey %llu", iterationCounter, execKey);

						testResult = SDLTest_RunTest(testSuite, testCase, execKey);

						if (testResult == TEST_RESULT_PASSED) {

							testPassedCount++;

							totalTestPassedCount++;

						} else if (testResult == TEST_RESULT_SKIPPED) {

							testSkippedCount++;

							totalTestSkippedCount++;

						} else {

							testFailedCount++;

							totalTestFailedCount++;

						}

					}

					// Take time - test end

					testEndSeconds = GetClock();

					runtime = testEndSeconds - testStartSeconds;

					if (runtime < 0.0f) runtime = 0.0f;

					if (testIterations > 1) {

						// Log test runtime

						SDLTest_Log("Runtime of %i iterations: %.1f sec", testIterations, runtime);

						SDLTest_Log("Average Test runtime: %.5f sec", runtime / (float)testIterations);

					} else {

						// Log test runtime

						SDLTest_Log("Total Test runtime: %.1f sec", runtime);

					}

					// Log final test result

					switch (testResult) {

					case TEST_RESULT_PASSED:

						SDLTest_Log((char *)SDLTest_FinalResultFormat, "Test", currentTestName, "Passed");

						break;

					case TEST_RESULT_FAILED:

						SDLTest_LogError((char *)SDLTest_FinalResultFormat, "Test", currentTestName, "Failed");

						break;

					case TEST_RESULT_NO_ASSERT:

						SDLTest_LogError((char *)SDLTest_FinalResultFormat,"Test", currentTestName, "No Asserts");

						break;

					}

				}

			}

			// Take time - suite end

			suiteEndSeconds = GetClock();

			runtime = suiteEndSeconds - suiteStartSeconds;

			if (runtime < 0.0f) runtime = 0.0f;

			// Log suite runtime

			SDLTest_Log("Total Suite runtime: %.1f sec", runtime);

			// Log summary and final Suite result

			countSum = testPassedCount + testFailedCount + testSkippedCount;

			if (testFailedCount == 0)

			{

				SDLTest_Log(logFormat, "Suite", countSum, testPassedCount, testFailedCount, testSkippedCount);

				SDLTest_Log((char *)SDLTest_FinalResultFormat, "Suite", currentSuiteName, "Passed");

			} 

			else 

			{

				SDLTest_LogError(logFormat, "Suite", countSum, testPassedCount, testFailedCount, testSkippedCount);

				SDLTest_LogError((char *)SDLTest_FinalResultFormat, "Suite", currentSuiteName, "Failed");

			}

		}

	}

	// Take time - run end

	runEndSeconds = GetClock();

	runtime = runEndSeconds - runStartSeconds;

	if (runtime < 0.0f) runtime = 0.0f;

	// Log total runtime

	SDLTest_Log("Total Run runtime: %.1f sec", runtime);

	// Log summary and final run result

	countSum = totalTestPassedCount + totalTestFailedCount + totalTestSkippedCount;

	if (totalTestFailedCount == 0)

	{

		runResult = 0;

		SDLTest_Log(logFormat, "Run", countSum, totalTestPassedCount, totalTestFailedCount, totalTestSkippedCount);

		SDLTest_Log((char *)SDLTest_FinalResultFormat, "Run /w seed", runSeed, "Passed");

	} 

	else 

	{

		runResult = 1;

		SDLTest_LogError(logFormat, "Run", countSum, totalTestPassedCount, totalTestFailedCount, totalTestSkippedCount);

		SDLTest_LogError((char *)SDLTest_FinalResultFormat, "Run /w seed", runSeed, "Failed");

	}

	SDLTest_Log("Exit code: %d", runResult);	

	return runResult;

}