Return to test.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / strongswan / src / libstrongswan / utils

Annotation of embedaddon/strongswan/src/libstrongswan/utils/test.h, revision 1.1

1.1     ! misho       1: /*
        !             2:  * Copyright (C) 2013 Tobias Brunner
        !             3:  * HSR Hochschule fuer Technik Rapperswil
        !             4:  *
        !             5:  * This program is free software; you can redistribute it and/or modify it
        !             6:  * under the terms of the GNU General Public License as published by the
        !             7:  * Free Software Foundation; either version 2 of the License, or (at your
        !             8:  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
        !             9:  *
        !            10:  * This program is distributed in the hope that it will be useful, but
        !            11:  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
        !            12:  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
        !            13:  * for more details.
        !            14:  */
        !            15: 
        !            16: /**
        !            17:  * @defgroup test test
        !            18:  * @{ @ingroup utils
        !            19:  */
        !            20: 
        !            21: #ifndef TEST_H_
        !            22: #define TEST_H_
        !            23: 
        !            24: #include "collections/hashtable.h"
        !            25: 
        !            26: /**
        !            27:  * Register a (possibly static) function so that it can be called from tests.
        !            28:  *
        !            29:  * @param name         name (namespace/function)
        !            30:  * @param fn           function to register (set to NULL to unregister)
        !            31:  */
        !            32: void testable_function_register(char *name, void *fn);
        !            33: 
        !            34: /**
        !            35:  * Find a previously registered testable function.
        !            36:  *
        !            37:  * @param name         name (namespace/function)
        !            38:  * @return                     function, NULL if not found
        !            39:  */
        !            40: void* testable_function_get(char *name);
        !            41: 
        !            42: /**
        !            43:  * Macro to automatically register/unregister a function that can be called
        !            44:  * from tests.
        !            45:  *
        !            46:  * @note The constructor has a priority set so that it runs after the
        !            47:  * constructor that creates the hashtable.  The destructor, on the other hand,
        !            48:  * does not have a priority set, as test coverage would report that function as
        !            49:  * untested otherwise.
        !            50:  *
        !            51:  * @param ns           namespace
        !            52:  * @param fn           function to register
        !            53:  */
        !            54: #define EXPORT_FUNCTION_FOR_TESTS(ns, fn) \
        !            55: static void testable_function_register_##fn() __attribute__ ((constructor)); \
        !            56: static void testable_function_register_##fn() \
        !            57: { \
        !            58:        testable_function_register(#ns "/" #fn, fn); \
        !            59: } \
        !            60: static void testable_function_unregister_##fn() __attribute__ ((destructor)); \
        !            61: static void testable_function_unregister_##fn() \
        !            62: { \
        !            63:        testable_function_register(#ns "/" #fn, NULL); \
        !            64: }
        !            65: 
        !            66: /**
        !            67:  * Import a registered function so that it can be called from tests.
        !            68:  *
        !            69:  * @param ns           namespace of the function
        !            70:  * @param name         name of the function
        !            71:  * @param ret          return type of the function
        !            72:  * @param ...          arguments of the function
        !            73:  */
        !            74: #define IMPORT_FUNCTION_FOR_TESTS(ns, name, ret, ...) \
        !            75: static ret (*TEST_##ns##name)(__VA_ARGS__);
        !            76: 
        !            77: /**
        !            78:  * Call a registered function from tests.
        !            79:  *
        !            80:  * @param ns           namespace of the function
        !            81:  * @param name         name of the function
        !            82:  * @param ...          arguments for the function
        !            83:  */
        !            84: #define TEST_FUNCTION(ns, name, ...) \
        !            85: ({ \
        !            86:        TEST_##ns##name = testable_function_get( #ns "/" #name); \
        !            87:        if (!TEST_##ns##name) \
        !            88:        { \
        !            89:                test_fail_msg(__FILE__, __LINE__, "function " #name " (" #ns ") not found"); \
        !            90:        } \
        !            91:        TEST_##ns##name(__VA_ARGS__); \
        !            92: })
        !            93: 
        !            94: #endif /** TEST_H_ @}*/