Blame test/CuTest.h

Packit 3adb1e
/* 
Packit 3adb1e
 * Copyright (c) 2003 Asim Jalis
Packit 3adb1e
 * 
Packit 3adb1e
 *  This software is provided 'as-is', without any express or implied
Packit 3adb1e
 *  warranty. In no event will the authors be held liable for any
Packit 3adb1e
 *  damages arising from the use of this software.
Packit 3adb1e
 * 
Packit 3adb1e
 *  Permission is granted to anyone to use this software for any
Packit 3adb1e
 *  purpose, including commercial applications, and to alter it and
Packit 3adb1e
 *  redistribute it freely, subject to the following restrictions:
Packit 3adb1e
 * 
Packit 3adb1e
 *  1. The origin of this software must not be misrepresented; you
Packit 3adb1e
 *  must not claim that you wrote the original software. If you use
Packit 3adb1e
 *  this software in a product, an acknowledgment in the product
Packit 3adb1e
 *  documentation would be appreciated but is not required.
Packit 3adb1e
 * 
Packit 3adb1e
 *  2. Altered source versions must be plainly marked as such, and
Packit 3adb1e
 *  must not be misrepresented as being the original software.
Packit 3adb1e
 * 
Packit 3adb1e
 *  3. This notice may not be removed or altered from any source
Packit 3adb1e
 *  distribution.
Packit 3adb1e
 *-------------------------------------------------------------------------*
Packit 3adb1e
 *
Packit 3adb1e
 * Originally obtained from "http://cutest.sourceforge.net/" version 1.4.
Packit 3adb1e
 *
Packit 3adb1e
 * Modified for serf as follows
Packit 3adb1e
 *    4) added CuSuiteSetSetupTeardownCallbacks to set a constructor and
Packit 3adb1e
 *       destructor per test suite, run for each test.
Packit 3adb1e
 *    3) added CuAssertStrnEquals(), CuAssertStrnEquals_Msg() and
Packit 3adb1e
 *       CuAssertStrnEquals_LineMsg()
Packit 3adb1e
 *    2) removed const from struct CuTest.name
Packit 3adb1e
 *    1) added CuStringFree(), CuTestFree(), CuSuiteFree(), and
Packit 3adb1e
 *       CuSuiteFreeDeep()
Packit 3adb1e
 *    0) reformatted the whitespace (doh!)
Packit 3adb1e
 */
Packit 3adb1e
#ifndef CU_TEST_H
Packit 3adb1e
#define CU_TEST_H
Packit 3adb1e
Packit 3adb1e
#include <setjmp.h>
Packit 3adb1e
#include <stdarg.h>
Packit 3adb1e
Packit 3adb1e
/* CuString */
Packit 3adb1e
Packit 3adb1e
char* CuStrAlloc(int size);
Packit 3adb1e
char* CuStrCopy(const char* old);
Packit 3adb1e
Packit 3adb1e
#define CU_ALLOC(TYPE)		((TYPE*) malloc(sizeof(TYPE)))
Packit 3adb1e
Packit 3adb1e
#define HUGE_STRING_LEN	8192
Packit 3adb1e
#define STRING_MAX		256
Packit 3adb1e
#define STRING_INC		256
Packit 3adb1e
Packit 3adb1e
typedef struct
Packit 3adb1e
{
Packit 3adb1e
    int length;
Packit 3adb1e
    int size;
Packit 3adb1e
    char* buffer;
Packit 3adb1e
} CuString;
Packit 3adb1e
Packit 3adb1e
void CuStringInit(CuString* str);
Packit 3adb1e
CuString* CuStringNew(void);
Packit 3adb1e
void CuStringFree(CuString *str);
Packit 3adb1e
void CuStringRead(CuString* str, const char* path);
Packit 3adb1e
void CuStringAppend(CuString* str, const char* text);
Packit 3adb1e
void CuStringAppendChar(CuString* str, char ch);
Packit 3adb1e
void CuStringAppendFormat(CuString* str, const char* format, ...);
Packit 3adb1e
void CuStringInsert(CuString* str, const char* text, int pos);
Packit 3adb1e
void CuStringResize(CuString* str, int newSize);
Packit 3adb1e
Packit 3adb1e
/* CuTest */
Packit 3adb1e
Packit 3adb1e
typedef struct CuTest CuTest;
Packit 3adb1e
Packit 3adb1e
typedef void (*TestFunction)(CuTest *);
Packit 3adb1e
Packit 3adb1e
typedef void *(*TestCallback)(void *baton);
Packit 3adb1e
Packit 3adb1e
struct CuTest
Packit 3adb1e
{
Packit 3adb1e
    char* name;
Packit 3adb1e
    TestFunction function;
Packit 3adb1e
    int failed;
Packit 3adb1e
    int ran;
Packit 3adb1e
    const char* message;
Packit 3adb1e
    jmp_buf *jumpBuf;
Packit 3adb1e
Packit 3adb1e
    TestCallback setup;
Packit 3adb1e
    TestCallback teardown;
Packit 3adb1e
    void *testBaton;
Packit 3adb1e
};
Packit 3adb1e
Packit 3adb1e
void CuTestInit(CuTest* t, const char* name, TestFunction function);
Packit 3adb1e
CuTest* CuTestNew(const char* name, TestFunction function);
Packit 3adb1e
void CuTestFree(CuTest* tc);
Packit 3adb1e
void CuTestRun(CuTest* tc);
Packit 3adb1e
Packit 3adb1e
/* Internal versions of assert functions -- use the public versions */
Packit 3adb1e
void CuFail_Line(CuTest* tc, const char* file, int line, const char* message2, const char* message);
Packit 3adb1e
void CuAssert_Line(CuTest* tc, const char* file, int line, const char* message, int condition);
Packit 3adb1e
void CuAssertStrEquals_LineMsg(CuTest* tc,
Packit 3adb1e
    const char* file, int line, const char* message,
Packit 3adb1e
    const char* expected, const char* actual);
Packit 3adb1e
void CuAssertStrnEquals_LineMsg(CuTest* tc,
Packit 3adb1e
    const char* file, int line, const char* message,
Packit 3adb1e
    const char* expected, size_t explen, const char* actual);
Packit 3adb1e
void CuAssertIntEquals_LineMsg(CuTest* tc,
Packit 3adb1e
    const char* file, int line, const char* message,
Packit 3adb1e
    int expected, int actual);
Packit 3adb1e
void CuAssertDblEquals_LineMsg(CuTest* tc,
Packit 3adb1e
    const char* file, int line, const char* message,
Packit 3adb1e
    double expected, double actual, double delta);
Packit 3adb1e
void CuAssertPtrEquals_LineMsg(CuTest* tc,
Packit 3adb1e
    const char* file, int line, const char* message,
Packit 3adb1e
    void* expected, void* actual);
Packit 3adb1e
Packit 3adb1e
/* public assert functions */
Packit 3adb1e
Packit 3adb1e
#define CuFail(tc, ms)                        CuFail_Line(  (tc), __FILE__, __LINE__, NULL, (ms))
Packit 3adb1e
#define CuAssert(tc, ms, cond)                CuAssert_Line((tc), __FILE__, __LINE__, (ms), (cond))
Packit 3adb1e
#define CuAssertTrue(tc, cond)                CuAssert_Line((tc), __FILE__, __LINE__, "assert failed", (cond))
Packit 3adb1e
Packit 3adb1e
#define CuAssertStrEquals(tc,ex,ac)           CuAssertStrEquals_LineMsg((tc),__FILE__,__LINE__,NULL,(ex),(ac))
Packit 3adb1e
#define CuAssertStrEquals_Msg(tc,ms,ex,ac)    CuAssertStrEquals_LineMsg((tc),__FILE__,__LINE__,(ms),(ex),(ac))
Packit 3adb1e
#define CuAssertStrnEquals(tc,ex,exlen,ac)        CuAssertStrnEquals_LineMsg((tc),__FILE__,__LINE__,NULL,(ex),(exlen),(ac))
Packit 3adb1e
#define CuAssertStrnEquals_Msg(tc,ms,ex,exlen,ac) CuAssertStrnEquals_LineMsg((tc),__FILE__,__LINE__,(ms),(ex),(exlen),(ac))
Packit 3adb1e
#define CuAssertIntEquals(tc,ex,ac)           CuAssertIntEquals_LineMsg((tc),__FILE__,__LINE__,NULL,(ex),(ac))
Packit 3adb1e
#define CuAssertIntEquals_Msg(tc,ms,ex,ac)    CuAssertIntEquals_LineMsg((tc),__FILE__,__LINE__,(ms),(ex),(ac))
Packit 3adb1e
#define CuAssertDblEquals(tc,ex,ac,dl)        CuAssertDblEquals_LineMsg((tc),__FILE__,__LINE__,NULL,(ex),(ac),(dl))
Packit 3adb1e
#define CuAssertDblEquals_Msg(tc,ms,ex,ac,dl) CuAssertDblEquals_LineMsg((tc),__FILE__,__LINE__,(ms),(ex),(ac),(dl))
Packit 3adb1e
#define CuAssertPtrEquals(tc,ex,ac)           CuAssertPtrEquals_LineMsg((tc),__FILE__,__LINE__,NULL,(ex),(ac))
Packit 3adb1e
#define CuAssertPtrEquals_Msg(tc,ms,ex,ac)    CuAssertPtrEquals_LineMsg((tc),__FILE__,__LINE__,(ms),(ex),(ac))
Packit 3adb1e
Packit 3adb1e
#define CuAssertPtrNotNull(tc,p)        CuAssert_Line((tc),__FILE__,__LINE__,"null pointer unexpected",(p != NULL))
Packit 3adb1e
#define CuAssertPtrNotNullMsg(tc,msg,p) CuAssert_Line((tc),__FILE__,__LINE__,(msg),(p != NULL))
Packit 3adb1e
Packit 3adb1e
/* CuSuite */
Packit 3adb1e
Packit 3adb1e
#define MAX_TEST_CASES	1024
Packit 3adb1e
Packit 3adb1e
#define SUITE_ADD_TEST(SUITE,TEST)	CuSuiteAdd(SUITE, CuTestNew(#TEST, TEST))
Packit 3adb1e
Packit 3adb1e
typedef struct
Packit 3adb1e
{
Packit 3adb1e
    int count;
Packit 3adb1e
    CuTest* list[MAX_TEST_CASES];
Packit 3adb1e
    int failCount;
Packit 3adb1e
Packit 3adb1e
    TestCallback setup;
Packit 3adb1e
    TestCallback teardown;
Packit 3adb1e
    void *testBaton;
Packit 3adb1e
} CuSuite;
Packit 3adb1e
Packit 3adb1e
Packit 3adb1e
void CuSuiteInit(CuSuite* testSuite);
Packit 3adb1e
CuSuite* CuSuiteNew(void);
Packit 3adb1e
void CuSuiteFree(CuSuite *testSuite);
Packit 3adb1e
void CuSuiteFreeDeep(CuSuite *testSuite);
Packit 3adb1e
void CuSuiteAdd(CuSuite* testSuite, CuTest *testCase);
Packit 3adb1e
void CuSuiteAddSuite(CuSuite* testSuite, CuSuite* testSuite2);
Packit 3adb1e
void CuSuiteRun(CuSuite* testSuite);
Packit 3adb1e
void CuSuiteSummary(CuSuite* testSuite, CuString* summary);
Packit 3adb1e
void CuSuiteDetails(CuSuite* testSuite, CuString* details);
Packit 3adb1e
Packit 3adb1e
void CuSuiteSetSetupTeardownCallbacks(CuSuite* testSuite, TestCallback setup,
Packit 3adb1e
                                      TestCallback teardown);
Packit 3adb1e
Packit 3adb1e
#endif /* CU_TEST_H */