docs/api-2.1/test_8h_source.html

 /*
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright 2017 Mike Becker, Olaf Wintermann All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  *
  *   1. Redistributions of source code must retain the above copyright
  *      notice, this list of conditions and the following disclaimer.
  *
  *   2. 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.
  *
  * 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 HOLDER 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.
  */

 #ifndef UCX_TEST_H
 #define UCX_TEST_H

 #include "ucx.h"
 #include <stdio.h>
 #include <string.h>
 #include <setjmp.h>

 #ifdef  __cplusplus
 extern "C" {
 #endif

 #ifndef __FUNCTION__

 #define __FUNCTION__ __func__
 #endif

 typedef struct UcxTestSuite UcxTestSuite;

 typedef void(*UcxTest)(UcxTestSuite*,FILE*);

 typedef struct UcxTestList UcxTestList;

 struct UcxTestList {

     UcxTest test;

     UcxTestList *next;
 };

 struct UcxTestSuite {

     unsigned int success;

     unsigned int failure;

     UcxTestList *tests;
 };

 UcxTestSuite* ucx_test_suite_new();

 void ucx_test_suite_free(UcxTestSuite* suite);

 int ucx_test_register(UcxTestSuite* suite, UcxTest test);

 void ucx_test_run(UcxTestSuite* suite, FILE* outstream);

 #define UCX_TEST(name) void name(UcxTestSuite* _suite_,FILE *_output_)

 #define UCX_TEST_BEGIN fwrite("Running ", 1, 8, _output_);\
         fwrite(__FUNCTION__, 1, strlen(__FUNCTION__), _output_);\
         fwrite("... ", 1, 4, _output_);\
         jmp_buf _env_; \
         if (!setjmp(_env_)) {

 #define UCX_TEST_ASSERT(condition,message) if (!(condition)) { \
         fwrite(message".\n", 1, 2+strlen(message), _output_); \
         _suite_->failure++; \
         longjmp(_env_, 1);\
     }

 #define UCX_TEST_SUBROUTINE(name,...) void name(UcxTestSuite* _suite_,\
         FILE *_output_, jmp_buf _env_, __VA_ARGS__)

 #define UCX_TEST_CALL_SUBROUTINE(name,...) \
         name(_suite_,_output_,_env_,__VA_ARGS__);

 #define UCX_TEST_END fwrite("success.\n", 1, 9, _output_); _suite_->success++;}

 #ifdef  __cplusplus
 }
 #endif

 #endif  /* UCX_TEST_H */

UcxTestSuite::success
unsigned int success
The number of successful tests after the suite has been run.
Definition: test.h:119

universe@390: string.h
Bounded string implementation.

universe@390: ucx.h
Main UCX Header providing most common definitions.

universe@390: UcxTestList::test
UcxTest test
Test case.
Definition: test.h:107

universe@390: ucx_test_register
int ucx_test_register(UcxTestSuite *suite, UcxTest test)
Registers a test function with the specified test suite.
Definition: test.c:52

universe@390: ucx_test_run
void ucx_test_run(UcxTestSuite *suite, FILE *outstream)
Runs a test suite and writes the test log to the specified stream.
Definition: test.c:82

universe@390: UcxTestList
Structure for the internal list of test cases.
Definition: test.h:104

universe@390: ucx_test_suite_new
UcxTestSuite * ucx_test_suite_new()
Creates a new test suite.
Definition: test.c:31

universe@390: UcxTestSuite::tests
UcxTestList * tests
Internal list of test cases.
Definition: test.h:128

universe@390: UcxTest
void(* UcxTest)(UcxTestSuite *, FILE *)
Pointer to a test function.
Definition: test.h:98

universe@390: ucx_test_suite_free
void ucx_test_suite_free(UcxTestSuite *suite)
Destroys a test suite.
Definition: test.c:42

universe@390: UcxTestSuite::failure
unsigned int failure
The number of failed tests after the suite has been run.
Definition: test.h:122

universe@390: UcxTestList::next
UcxTestList * next
Pointer to the next list element.
Definition: test.h:110

universe@390: UcxTestSuite
A test suite containing multiple test cases.
Definition: test.h:116

universe@390: