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 #include "wx/string.h"
  59
  60
  61 ///////////////////////////////////////////////////////////////////////////////
  62 // Set of helpful test macros.
  63 //
  64
  65 // Base macro for wrapping CPPUNIT_TEST macros and so making them conditional
  66 // tests, meaning that the test only get registered and thus run when a given
  67 // runtime condition is true.
  68 // In case the condition is evaluated as false a skip message is logged
  69 // (the message will only be shown in verbose mode).
  70 #define WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, anyTest) \
  71     if (Condition) \
  72         { anyTest; } \
  73     else \
  74         wxLogInfo(wxString::Format(_T("skipping: %s.%s\n  reason: %s equals false\n"), \
  75                                     wxString(suiteName, wxConvUTF8).c_str(), \
  76                                     wxString(#testMethod, wxConvUTF8).c_str(), \
  77                                     wxString(#Condition, wxConvUTF8).c_str()))
  78
  79 // Conditional CPPUNIT_TEST macro.
  80 #define WXTEST_WITH_CONDITION(suiteName, Condition, testMethod) \
  81     WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, CPPUNIT_TEST(testMethod))
  82 // Conditional CPPUNIT_TEST_FAIL macro.
  83 #define WXTEST_FAIL_WITH_CONDITION(suiteName, Condition, testMethod) \
  84     WXTEST_ANY_WITH_CONDITION(suiteName, Condition, testMethod, CPPUNIT_TEST_FAIL(testMethod))
  85
  86 CPPUNIT_NS_BEGIN
  87
  88 // provide an overload of cppunit assertEquals(T, T) which can be used to
  89 // compare wxStrings directly with C strings
  90 inline void
  91 assertEquals(const char *expected,
  92              const wxString& actual,
  93              CppUnit::SourceLine sourceLine,
  94              const std::string& message)
  95 {
  96     assertEquals(wxString(expected), actual, sourceLine, message);
  97 }
  98
  99 inline void
 100 assertEquals(const wchar_t *expected,
 101              const wxString& actual,
 102              CppUnit::SourceLine sourceLine,
 103              const std::string& message)
 104 {
 105     assertEquals(wxString(expected), actual, sourceLine, message);
 106 }
 107
 108 #define WX_CPPUNIT_ASSERT_EQUALS(T1, T2)                                      \
 109     inline void                                                               \
 110     assertEquals(T1 expected,                                                 \
 111                  T2 actual,                                                   \
 112                  CppUnit::SourceLine sourceLine,                              \
 113                  const std::string& message)                                  \
 114     {                                                                         \
 115         if ( !assertion_traits<T1>::equal(expected,actual) )                  \
 116         {                                                                     \
 117             Asserter::failNotEqual( assertion_traits<T1>::toString(expected), \
 118                                     assertion_traits<T2>::toString(actual),   \
 119                                     sourceLine,                               \
 120                                     message );                                \
 121         }                                                                     \
 122     }
 123
 124 // and another to be able to specify (usually literal) ints as expected values
 125 // for functions returning size_t
 126 WX_CPPUNIT_ASSERT_EQUALS(int, size_t)
 127 WX_CPPUNIT_ASSERT_EQUALS(int, wxFileOffset)
 128
 129 // special section with VC6 workarounds: due to incorrect resolution of
 130 // overloaded/template functions in this compiler (it basically doesn't use the
 131 // template version at all if any overloaded function matches partially even if
 132 // none of them matches fully) we also need
 133 #ifdef __VISUALC6__
 134
 135 WX_CPPUNIT_ASSERT_EQUALS(int, int)
 136 WX_CPPUNIT_ASSERT_EQUALS(size_t, size_t)
 137 WX_CPPUNIT_ASSERT_EQUALS(wxFileOffset, wxFileOffset)
 138
 139 #endif // VC6
 140
 141 CPPUNIT_NS_END
 142
 143 // Use this macro to compare a wxArrayString with the pipe-separated elements
 144 // of the given string
 145 //
 146 // NB: it's a macro and not a function to have the correct line numbers in the
 147 //     test failure messages
 148 #define WX_ASSERT_STRARRAY_EQUAL(s, a)                                        \
 149     {                                                                         \
 150         wxArrayString expected(wxSplit(s, '|', '\0'));                        \
 151                                                                               \
 152         CPPUNIT_ASSERT_EQUAL( expected.size(), a.size() );                    \
 153                                                                               \
 154         for ( size_t n = 0; n < a.size(); n++ )                               \
 155         {                                                                     \
 156             CPPUNIT_ASSERT_EQUAL( expected[n], a[n] );                        \
 157         }                                                                     \
 158     }
 159
 160 // Use this macro to assert with the given formatted message (it should contain
 161 // the format string and arguments in a separate pair of parentheses)
 162 #define WX_ASSERT_MESSAGE(msg, cond) \
 163     CPPUNIT_ASSERT_MESSAGE(std::string(wxString::Format msg .mb_str()), (cond))
 164
 165 #define WX_ASSERT_EQUAL_MESSAGE(msg, expected, actual) \
 166     CPPUNIT_ASSERT_EQUAL_MESSAGE(std::string(wxString::Format msg .mb_str()), \
 167                                  (expected), (actual))
 168
 169 ///////////////////////////////////////////////////////////////////////////////
 170 // define stream inserter for wxString if it's not defined in the main library,
 171 // we need it to output the test failures involving wxString
 172 #if !wxUSE_STD_IOSTREAM
 173
 174 #include "wx/string.h"
 175
 176 #include <iostream>
 177
 178 inline std::ostream& operator<<(std::ostream& o, const wxString& s)
 179 {
 180 #if wxUSE_UNICODE
 181     return o << (const char *)wxSafeConvertWX2MB(s.wc_str());
 182 #else
 183     return o << s.c_str();
 184 #endif
 185 }
 186
 187 #endif // !wxUSE_STD_IOSTREAM
 188
 189 // VC6 doesn't provide overloads for operator<<(__int64) in its stream classes
 190 // so do it ourselves
 191 #if defined(__VISUALC6__) && defined(wxLongLong_t)
 192
 193 #include "wx/longlong.h"
 194
 195 inline std::ostream& operator<<(std::ostream& ostr, wxLongLong_t ll)
 196 {
 197     ostr << wxLongLong(ll).ToString();
 198
 199     return ostr;
 200 }
 201
 202 inline std::ostream& operator<<(std::ostream& ostr, unsigned wxLongLong_t llu)
 203 {
 204     ostr << wxULongLong(llu).ToString();
 205
 206     return ostr;
 207 }
 208
 209 #endif // VC6 && wxLongLong_t
 210
 211 ///////////////////////////////////////////////////////////////////////////////
 212 // Some more compiler warning tweaking and auto linking.
 213 //
 214
 215 #ifdef __BORLANDC__
 216     #pragma warn .8022
 217 #endif
 218
 219 #ifdef _MSC_VER
 220   #pragma warning(default:4702)
 221 #endif // _MSC_VER
 222
 223 // for VC++ automatically link in cppunit library
 224 #ifdef __VISUALC__
 225   #ifdef NDEBUG
 226     #pragma comment(lib, "cppunit.lib")
 227   #else // Debug
 228     #pragma comment(lib, "cppunitd.lib")
 229   #endif // Release/Debug
 230 #endif
 231
 232 #endif // _WX_CPPUNIT_H_
 233