strongswan/src/libstrongswan/utils/test.h

95 lines
2.8 KiB
C

/*
* Copyright (C) 2013 Tobias Brunner
* HSR Hochschule fuer Technik Rapperswil
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation; either version 2 of the License, or (at your
* option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* for more details.
*/
/**
* @defgroup test test
* @{ @ingroup utils
*/
#ifndef TEST_H_
#define TEST_H_
#include "collections/hashtable.h"
/**
* Register a (possibly static) function so that it can be called from tests.
*
* @param name name (namespace/function)
* @param fn function to register (set to NULL to unregister)
*/
void testable_function_register(char *name, void *fn);
/**
* Find a previously registered testable function.
*
* @param name name (namespace/function)
* @return function, NULL if not found
*/
void* testable_function_get(char *name);
/**
* Macro to automatically register/unregister a function that can be called
* from tests.
*
* @note The constructor has a priority set so that it runs after the
* constructor that creates the hashtable. The destructor, on the other hand,
* does not have a priority set, as test coverage would report that function as
* untested otherwise.
*
* @param ns namespace
* @param fn function to register
*/
#define EXPORT_FUNCTION_FOR_TESTS(ns, fn) \
static void testable_function_register_##fn() __attribute__ ((constructor)); \
static void testable_function_register_##fn() \
{ \
testable_function_register(#ns "/" #fn, fn); \
} \
static void testable_function_unregister_##fn() __attribute__ ((destructor)); \
static void testable_function_unregister_##fn() \
{ \
testable_function_register(#ns "/" #fn, NULL); \
}
/**
* Import a registered function so that it can be called from tests.
*
* @param ns namespace of the function
* @param name name of the function
* @param ret return type of the function
* @param ... arguments of the function
*/
#define IMPORT_FUNCTION_FOR_TESTS(ns, name, ret, ...) \
static ret (*TEST_##ns##name)(__VA_ARGS__);
/**
* Call a registered function from tests.
*
* @param ns namespace of the function
* @param name name of the function
* @param ... arguments for the function
*/
#define TEST_FUNCTION(ns, name, ...) \
({ \
TEST_##ns##name = testable_function_get( #ns "/" #name); \
if (!TEST_##ns##name) \
{ \
test_fail_msg(__FILE__, __LINE__, "function " #name " (" #ns ") not found"); \
} \
TEST_##ns##name(__VA_ARGS__); \
})
#endif /** TEST_H_ @}*/