logger.h 3.31 KB
/*
  Copyright (C) 2011 Markus Kauppila <markus.kauppila@gmail.com>

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

#ifndef _LOGGER_H
#define _LOGGER_H

#include <time.h>

/* Logging levels */
typedef enum Level {
	STANDARD = 1,
	VERBOSE
} Level;


typedef struct LoggerData {
	//! If enabled logger will write to stdout instead of file
	int stdoutEnabled;
	//!< Name and directory of the log file (ie. logs/runner-seed.log)
	char *filename;
	//!< Logging level of the logger (such as VERBOSE)
	Level level;
	//!< Some custom data that a logger needs
	void  *custom;
} LoggerData;

/*!
 * Typedefs for function pointers that implement the  generic
 * logging interface. See the headers of implementations (plain_logger.h or
 * xml_logger.h) for more information.
 */
typedef	void (*RunStartedFp)(int parameterCount, char *runnerParameters[], char *runSeed, time_t eventTime, LoggerData *data);
typedef	void (*RunEndedFp)(int testCount, int suiteCount, int testPassCount, int testFailCount,
                           int testSkippedCount, time_t endTime, double totalRuntime);

typedef	void (*SuiteStartedFp)(const char *suiteName, time_t eventTime);
typedef	void (*SuiteEndedFp)(int testsPassed, int testsFailed, int testsSkipped,
		                time_t endTime, double totalRuntime);

typedef	void (*TestStartedFp)(const char *testName, const char *suiteName,
                              const char *testDescription, char *execKey, time_t startTime);
typedef	void (*TestEndedFp)(const char *testName, const char *suiteName, int testResult,
                            time_t endTime, double totalRuntime);

typedef	void (*AssertFp)(const char *assertName, int assertResult,
						 const char *assertMessage, time_t eventTime);

typedef	void (*AssertWithValuesFp)(const char *assertName, int assertResult,
						 const char *assertMessage, int actualValue, int expected,
						 time_t eventTime);

typedef	void (*AssertSummaryFp)(int numAsserts, int numAssertsFailed,
								int numAssertsPass, time_t eventTime);

typedef	void (*LogFp)(time_t eventTime, char *fmt, ...);


/*! Function pointers to actual logging function implementations */

extern RunStartedFp RunStarted;
extern RunEndedFp RunEnded;
extern SuiteStartedFp SuiteStarted;
extern SuiteEndedFp SuiteEnded;
extern TestStartedFp TestStarted;
extern TestEndedFp TestEnded;
extern AssertFp Assert;
extern AssertWithValuesFp AssertWithValues;
extern AssertSummaryFp AssertSummary;
extern LogFp Log;

//! \todo move these two away from here
extern char *globalExecKey;
//! Run seed for harness
extern char *runSeed;


#endif