]>
git.saurik.com Git - wxWidgets.git/blob - include/wx/cppunit.h
1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wrapper header for CppUnit headers
4 // Author: Vadim Zeitlin
7 // Copyright: (c) 2004 Vadim Zeitlin
8 // Licence: wxWindows Licence
9 /////////////////////////////////////////////////////////////////////////////
11 #ifndef _WX_CPPUNIT_H_
12 #define _WX_CPPUNIT_H_
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
18 // typedef-name 'foo' used as synonym for class-name 'bar'
19 #pragma warning(disable:4097)
21 // unreachable code: we don't care about warnings in CppUnit headers
22 #pragma warning(disable:4702)
24 // 'id': identifier was truncated to 'num' characters in the debug info
25 #pragma warning(disable:4786)
32 #ifndef CPPUNIT_STD_NEED_ALLOCATOR
33 #define CPPUNIT_STD_NEED_ALLOCATOR 0
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++).
41 #ifndef CPPUNIT_COMPILER_LOCATION_FORMAT
42 #define CPPUNIT_COMPILER_LOCATION_FORMAT "%p:%l:"
46 ///////////////////////////////////////////////////////////////////////////////
47 // Include all needed cppunit headers.
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"
58 #include "wx/string.h"
61 ///////////////////////////////////////////////////////////////////////////////
62 // Set of helpful test macros.
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) \
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()))
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))
88 // provide an overload of cppunit assertEquals(T, T) which can be used to
89 // compare wxStrings directly with C strings
91 assertEquals(const char *expected
,
92 const wxString
& actual
,
93 CppUnit::SourceLine sourceLine
,
94 const std::string
& message
)
96 assertEquals(wxString(expected
), actual
, sourceLine
, message
);
100 assertEquals(const wchar_t *expected
,
101 const wxString
& actual
,
102 CppUnit::SourceLine sourceLine
,
103 const std::string
& message
)
105 assertEquals(wxString(expected
), actual
, sourceLine
, message
);
108 #define WX_CPPUNIT_ASSERT_EQUALS(T1, T2) \
110 assertEquals(T1 expected, \
112 CppUnit::SourceLine sourceLine, \
113 const std::string& message) \
115 if ( !assertion_traits<T1>::equal(expected,actual) ) \
117 Asserter::failNotEqual( assertion_traits<T1>::toString(expected), \
118 assertion_traits<T2>::toString(actual), \
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);
128 // special section with VC6 workarounds: due to incorrect resolution of
129 // overloaded/template functions in this compiler (it basically doesn't use the
130 // template version at all if any overloaded function matches partially even if
131 // none of them matches fully) we also need
134 WX_CPPUNIT_ASSERT_EQUALS(int, int);
135 WX_CPPUNIT_ASSERT_EQUALS(size_t, size_t);
141 // Use this macro to compare a wxArrayString with the pipe-separated elements
142 // of the given string
144 // NB: it's a macro and not a function to have the correct line numbers in the
145 // test failure messages
146 #define WX_ASSERT_STRARRAY_EQUAL(s, a) \
148 wxArrayString expected(wxSplit(s, '|', '\0')); \
150 CPPUNIT_ASSERT_EQUAL( expected.size(), a.size() ); \
152 for ( size_t n = 0; n < a.size(); n++ ) \
154 CPPUNIT_ASSERT_EQUAL( expected[n], a[n] ); \
158 // Use this macro to assert with the given formatted message (it should contain
159 // the format string and arguments in a separate pair of parentheses)
160 #define WX_ASSERT_MESSAGE(msg, cond) \
161 CPPUNIT_ASSERT_MESSAGE(std::string(wxString::Format msg .mb_str()), (cond))
163 ///////////////////////////////////////////////////////////////////////////////
164 // define stream inserter for wxString if it's not defined in the main library,
165 // we need it to output the test failures involving wxString
166 #if !wxUSE_STD_IOSTREAM
168 #include "wx/string.h"
172 inline std::ostream
& operator<<(std::ostream
& o
, const wxString
& s
)
175 return o
<< (const char *)wxSafeConvertWX2MB(s
.wc_str());
177 return o
<< s
.c_str();
181 // VC6 doesn't provide overloads for operator<<(__int64) in its stream classes
182 // so do it ourselves
183 #if defined(__VISUALC6__) && defined(wxLongLong_t)
185 #include "wx/longlong.h"
187 inline std::ostream
& operator<<(std::ostream
& ostr
, wxLongLong_t ll
)
189 ostr
<< wxLongLong(ll
).ToString();
194 inline std::ostream
& operator<<(std::ostream
& ostr
, unsigned wxLongLong_t llu
)
196 ostr
<< wxULongLong(llu
).ToString();
201 #endif // VC6 && wxLongLong_t
203 #endif // !wxUSE_STD_IOSTREAM
205 ///////////////////////////////////////////////////////////////////////////////
206 // Some more compiler warning tweaking and auto linking.
214 #pragma warning(default:4702)
217 // for VC++ automatically link in cppunit library
220 #pragma comment(lib, "cppunit.lib")
222 #pragma comment(lib, "cppunitd.lib")
223 #endif // Release/Debug
226 #endif // _WX_CPPUNIT_H_