X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=libtest%2Ftest.h;h=78cdb4e444ebfbbce220e5bd2ba9c55a06f83367;hb=27bed94f9adf2d67670daf8a237be68f5bb7a076;hp=cc0fd78aaaf21c8e5614c0776fdf4631ea355d76;hpb=349ca737f30ff0b6c3c71034f0930660663fa360;p=awesomized%2Flibmemcached diff --git a/libtest/test.h b/libtest/test.h index cc0fd78a..78cdb4e4 100644 --- a/libtest/test.h +++ b/libtest/test.h @@ -1,205 +1,219 @@ -/* uTest - * Copyright (C) 2006-2009 Brian Aker - * All rights reserved. +/* vim:expandtab:shiftwidth=2:tabstop=2:smarttab: + * + * Data Differential YATL (i.e. libtest) library + * + * Copyright (C) 2012 Data Differential, http://datadifferential.com/ + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above + * copyright notice, this list of conditions and the following disclaimer + * in the documentation and/or other materials provided with the + * distribution. + * + * * The names of its contributors may not be used to endorse or + * promote products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * - * Use and distribution licensed under the BSD license. See - * the COPYING file in the parent directory for full text. */ -/* - Structures for generic tests. -*/ +#pragma once -#ifdef __cplusplus -extern "C" { +#ifndef __INTEL_COMPILER +#pragma GCC diagnostic ignored "-Wold-style-cast" #endif -#include -#include -#include - -#if !defined(__cplusplus) -# include -#endif - -typedef struct world_st world_st; -typedef struct collection_st collection_st; -typedef struct test_st test_st; - -typedef enum { - TEST_SUCCESS= 0, /* Backwards compatibility */ - TEST_FAILURE, - TEST_MEMORY_ALLOCATION_FAILURE, - TEST_SKIPPED, - TEST_MAXIMUM_RETURN /* Always add new error code before */ -} test_return_t; - -typedef void *(*test_callback_create_fn)(test_return_t *error); -typedef test_return_t (*test_callback_fn)(void *); -typedef test_return_t (*test_callback_runner_fn)(test_callback_fn, void *); -typedef test_return_t (*test_callback_error_fn)(test_return_t, void *); - -/* Help function for use with gettimeofday() */ -long int timedif(struct timeval a, struct timeval b); - /** A structure describing the test case. */ struct test_st { const char *name; bool requires_flush; - test_callback_fn test_fn; + test_callback_fn *test_fn; }; +#define test_assert_errno(A) \ +do \ +{ \ + if ((A)) { \ + fprintf(stderr, "\n%s:%d: Assertion failed for %s: ", __FILE__, __LINE__, __func__);\ + perror(#A); \ + fprintf(stderr, "\n"); \ + libtest::create_core(); \ + assert((A)); \ + } \ +} while (0) -/** - A structure which describes a collection of test cases. -*/ -struct collection_st { - const char *name; - test_callback_fn pre; - test_callback_fn post; - test_st *tests; -}; - - -/** - Structure which houses the actual callers for the test cases contained in - the collections. -*/ -typedef struct { - test_callback_runner_fn pre; - test_callback_runner_fn run; - test_callback_runner_fn post; -} world_runner_st; - - -/** - world_st is the structure which is passed to the test implementation to be filled. - This must be implemented in order for the test framework to load the tests. We call - get_world() in order to fill this structure. -*/ - -struct world_st { - collection_st *collections; - - /* These methods are called outside of any collection call. */ - test_callback_create_fn create; - test_callback_fn destroy; - - struct { - /* This is called a the beginning of any test run. */ - test_callback_fn startup; - - /* This called on a test if the test requires a flush call (the bool is from test_st) */ - test_callback_fn flush; - - /** - These are run before/after the test. If implemented. Their execution is not controlled - by the test. - */ - test_callback_fn pre_run; - test_callback_fn post_run; +#define test_assert(A, B) \ +do \ +{ \ + if ((A)) { \ + fprintf(stderr, "\n%s:%d: Assertion failed %s, with message %s, in %s", __FILE__, __LINE__, (B), #A, __func__ );\ + fprintf(stderr, "\n"); \ + libtest::create_core(); \ + assert((A)); \ + } \ +} while (0) - /** - If an error occurs during the test, this is called. - */ - test_callback_error_fn on_error; - } test; +#define test_truth(A) \ +do \ +{ \ + if (! (A)) { \ + fprintf(stderr, "\n%s:%d: Assertion \"%s\" failed, in %s\n", __FILE__, __LINE__, #A, __func__);\ + libtest::create_core(); \ + return TEST_FAILURE; \ + } \ +} while (0) - struct { - /* This is called a the beginning of any collection run. */ - test_callback_fn startup; +#define test_true(A) \ +do \ +{ \ + if (! (A)) { \ + fprintf(stderr, "\n%s:%d: Assertion \"%s\" failed, in %s\n", __FILE__, __LINE__, #A, __func__);\ + libtest::create_core(); \ + return TEST_FAILURE; \ + } \ +} while (0) - /* This is called at the end of any collection run. */ - test_callback_fn shutdown; - } collection; +#define test_true_got(A, B) test_true(A); +#define test_true_hint(A, B) test_true(A); +#define test_compare_hint(A, B, C) test_compare(A, B); +#define test_compare_got(A, B, C) test_compare(A, B); - /** - Runner represents the callers for the tests. If not implemented we will use - a set of default implementations. - */ - world_runner_st *runner; -}; +#define test_skip(__expected, __actual) \ +do \ +{ \ + if (libtest::_compare(__FILE__, __LINE__, __func__, ((__expected)), ((__actual)), false) == false) \ + { \ + return TEST_SKIPPED; \ + } \ +} while (0) +#define test_skip_valgrind() \ +do \ +{ \ + if (libtest::_in_valgrind(__FILE__, __LINE__, __func__)) \ + { \ + return TEST_SKIPPED; \ + } \ +} while (0) +#define test_fail(A) \ +do \ +{ \ + if (1) { \ + fprintf(stderr, "\n%s:%d: Failed with %s, in %s\n", __FILE__, __LINE__, #A, __func__);\ + libtest::create_core(); \ + return TEST_FAILURE; \ + } \ +} while (0) -/** - @note world_stats_st is a simple structure for tracking test successes. -*/ -typedef struct { - uint32_t collection_success; - uint32_t collection_skipped; - uint32_t collection_failed; - uint32_t collection_total; - uint32_t success; - uint32_t skipped; - uint32_t failed; - uint32_t total; -} world_stats_st; - -/* How we make all of this work :) */ -void get_world(world_st *world); - -void create_core(void); -/** - @note Friendly print function for errors. -*/ -const char *test_strerror(test_return_t code); +#define test_false(A) \ +do \ +{ \ + if ((A)) { \ + fprintf(stderr, "\n%s:%d: Assertion failed %s, in %s\n", __FILE__, __LINE__, #A, __func__);\ + libtest::create_core(); \ + return TEST_FAILURE; \ + } \ +} while (0) -#define test_fail(A) \ +#define test_false_with(A,B) \ do \ { \ - if (1) { \ - fprintf(stderr, "\nFailed at %s:%d: %s\n", __FILE__, __LINE__, #A);\ - create_core(); \ + if ((A)) { \ + fprintf(stderr, "\n%s:%d: Assertion failed %s with %s\n", __FILE__, __LINE__, #A, (B));\ + libtest::create_core(); \ return TEST_FAILURE; \ } \ } while (0) -#define test_true(A) \ +#define test_ne_compare(__expected, __actual) \ do \ { \ - if (! (A)) { \ - fprintf(stderr, "\nAssertion failed at %s:%d: %s\n", __FILE__, __LINE__, #A);\ - create_core(); \ + if (libtest::_ne_compare(__FILE__, __LINE__, __func__, ((__expected)), ((__actual)), true) == false) \ + { \ + libtest::create_core(); \ return TEST_FAILURE; \ } \ } while (0) -#define test_true_got(A,B) \ +#define test_compare(__expected, __actual) \ do \ { \ - if (! (A)) { \ - fprintf(stderr, "\nAssertion failed at %s:%d: \"%s\" received \"%s\"\n", __FILE__, __LINE__, #A, (B));\ - create_core(); \ + if (libtest::_compare(__FILE__, __LINE__, __func__, ((__expected)), ((__actual)), true) == false) \ + { \ + libtest::create_core(); \ return TEST_FAILURE; \ } \ } while (0) -#define test_false(A) \ +#define test_zero(__actual) \ do \ { \ - if ((A)) { \ - fprintf(stderr, "\nAssertion failed at %s:%d: %s\n", __FILE__, __LINE__, #A);\ - create_core(); \ + if (libtest::_compare_zero(__FILE__, __LINE__, __func__, ((__actual))) == false) \ + { \ + libtest::create_core(); \ return TEST_FAILURE; \ } \ } while (0) -#define test_strcmp(A,B) \ +#define test_null test_zero + +#define test_compare_warn(__expected, __actual) \ +do \ +{ \ + void(libtest::_compare(__FILE__, __LINE__, __func__, (__expected), (__actual)), true); \ +} while (0) + +#define test_warn(__truth, __explain) \ +do \ +{ \ + void(libtest::_assert_truth(__FILE__, __LINE__, __func__, bool((__truth)), #__truth, __explain)); \ +} while (0) + +#define test_strcmp(__expected, __actual) \ +do \ +{ \ + void(libtest::_compare_strcmp(__FILE__, __LINE__, __func__, (__expected), (__actual))); \ +} while (0) + +#define test_memcmp(A,B,C) \ do \ { \ - if (strcmp((A), (B))) \ + if ((A) == NULL or (B) == NULL or memcmp((A), (B), (C))) \ { \ - fprintf(stderr, "\n%s:%d: %s -> %s\n", __FILE__, __LINE__, (A), (B)); \ - create_core(); \ + fprintf(stderr, "\n%s:%d: %.*s -> %.*s\n", __FILE__, __LINE__, (int)(C), (char *)(A), (int)(C), (char *)(B)); \ + libtest::create_core(); \ return TEST_FAILURE; \ } \ } while (0) -#ifdef __cplusplus -} -#endif +#define test_return_if(__test_return_t) \ +do \ +{ \ + if ((__test_return_t) != TEST_SUCCESS) \ + { \ + return __test_return_t; \ + } \ +} while (0) +