include/wx/cppunit.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/cppunit.h
   3 // Purpose:     wrapper header for CppUnit headers
   4 // Author:      Vadim Zeitlin
   5 // Created:     15.02.04
   6 // RCS-ID:      $Id$
   7 // Copyright:   (c) 2004 Vadim Zeitlin
   8 // Licence:     wxWindows Licence
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef _WX_CPPUNIT_H_
  12 #define _WX_CPPUNIT_H_
  13
  14 ///////////////////////////////////////////////////////////////////////////////
  15 // using CPPUNIT_TEST() macro results in this warning, disable it as there is
  16 // no other way to get rid of it and it's not very useful anyhow
  17 #ifdef __VISUALC__
  18     // typedef-name 'foo' used as synonym for class-name 'bar'
  19     #pragma warning(disable:4097)
  20
  21     // unreachable code: we don't care about warnings in CppUnit headers
  22     #pragma warning(disable:4702)
  23
  24     // 'id': identifier was truncated to 'num' characters in the debug info
  25     #pragma warning(disable:4786)
  26 #endif // __VISUALC__
  27
  28 #ifdef __BORLANDC__
  29     #pragma warn -8022
  30 #endif
  31
  32 #ifndef CPPUNIT_STD_NEED_ALLOCATOR
  33     #define CPPUNIT_STD_NEED_ALLOCATOR 0
  34 #endif
  35
  36 ///////////////////////////////////////////////////////////////////////////////
  37 // Set the default format for the errors, which can be used by an IDE to jump
  38 // to the error location. This default gets overridden by the cppunit headers
  39 // for some compilers (e.g. VC++).
  40
  41 #ifndef CPPUNIT_COMPILER_LOCATION_FORMAT
  42     #define CPPUNIT_COMPILER_LOCATION_FORMAT "%p:%l:"
  43 #endif
  44
  45
  46 ///////////////////////////////////////////////////////////////////////////////
  47 // Include all needed cppunit headers.
  48 //
  49
  50 #include "wx/beforestd.h"
  51 #include <cppunit/extensions/TestFactoryRegistry.h>
  52 #include <cppunit/ui/text/TestRunner.h>
  53 #include <cppunit/TestCase.h>
  54 #include <cppunit/extensions/HelperMacros.h>
  55 #include <cppunit/CompilerOutputter.h>
  56 #include "wx/afterstd.h"
  57
  58
  59 ///////////////////////////////////////////////////////////////////////////////
  60 // Set of helpful test macros.
  61 //
  62
  63 // Base macro for wrapping CPPUNIT_TEST macros and so making them conditional
  64 // tests, meaning that the test only get registered and thus run when a given
  65 // runtime condition is true.
  66 // In case the condition is evaluated as false a skip message is logged
  67 // (the message will only be shown in verbose mode).
  68 #define WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, anyTest) \
  69     if (Condition) \
  70         { anyTest; } \
  71     else \
  72         wxLogInfo(wxString::Format(_T("skipping: %s.%s\n  reason: %s equals false\n"), \
  73                                     wxString(suiteName, wxConvUTF8).c_str(), \
  74                                     wxString(#testMethod, wxConvUTF8).c_str(), \
  75                                     wxString(#Condition, wxConvUTF8).c_str()))
  76
  77 // Conditional CPPUNIT_TEST macro.
  78 #define WXTEST_WITH_CONDITION(suiteName, Condition, testMethod) \
  79     WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, CPPUNIT_TEST(testMethod))
  80 // Conditional CPPUNIT_TEST_FAIL macro.
  81 #define WXTEST_FAIL_WITH_CONDITION(suiteName, Condition, testMethod) \
  82     WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, CPPUNIT_TEST_FAIL(testMethod))
  83
  84 // Use this macro to compare a wxString with a literal string.
  85 #define WX_ASSERT_STR_EQUAL(p, s) CPPUNIT_ASSERT_EQUAL(wxString(p), s)
  86
  87 // Use this macro to compare a size_t with a literal integer
  88 #define WX_ASSERT_SIZET_EQUAL(n, m) CPPUNIT_ASSERT_EQUAL(((size_t)n), m)
  89
  90
  91 // Use this macro to assert with the given formatted message (it should contain
  92 // the format string and arguments in a separate pair of parentheses)
  93 #define WX_ASSERT_MESSAGE(msg, cond) \
  94     CPPUNIT_ASSERT_MESSAGE(std::string(wxString::Format msg .mb_str()), (cond))
  95
  96 ///////////////////////////////////////////////////////////////////////////////
  97 // define stream inserter for wxString if it's not defined in the main library,
  98 // we need it to output the test failures involving wxString
  99 #if !wxUSE_STD_IOSTREAM
 100
 101 #include "wx/string.h"
 102
 103 #include <iostream>
 104
 105 inline std::ostream& operator<<(std::ostream& o, const wxString& s)
 106 {
 107 #if wxUSE_UNICODE
 108     return o << (const char *)wxSafeConvertWX2MB(s.wc_str());
 109 #else
 110     return o << s.c_str();
 111 #endif
 112 }
 113
 114 // VC6 doesn't provide overloads for operator<<(__int64) in its stream classes
 115 // so do it ourselves
 116 #if defined(__VISUALC6__) && defined(wxLongLong_t)
 117
 118 #include "wx/longlong.h"
 119
 120 inline std::ostream& operator<<(std::ostream& ostr, wxLongLong_t ll)
 121 {
 122     ostr << wxLongLong(ll).ToString();
 123
 124     return ostr;
 125 }
 126
 127 inline std::ostream& operator<<(std::ostream& ostr, unsigned wxLongLong_t llu)
 128 {
 129     ostr << wxULongLong(llu).ToString();
 130
 131     return ostr;
 132 }
 133
 134 #endif // VC6 && wxLongLong_t
 135
 136 #endif // !wxUSE_STD_IOSTREAM
 137
 138 ///////////////////////////////////////////////////////////////////////////////
 139 // Some more compiler warning tweaking and auto linking.
 140 //
 141
 142 #ifdef __BORLANDC__
 143     #pragma warn .8022
 144 #endif
 145
 146 #ifdef _MSC_VER
 147   #pragma warning(default:4702)
 148 #endif // _MSC_VER
 149
 150 // for VC++ automatically link in cppunit library
 151 #ifdef __VISUALC__
 152   #ifdef NDEBUG
 153     #pragma comment(lib, "cppunit.lib")
 154   #else // Debug
 155     #pragma comment(lib, "cppunitd.lib")
 156   #endif // Release/Debug
 157 #endif
 158
 159 #endif // _WX_CPPUNIT_H_
 160