]>
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 // and another to be able to specify (usually literal) ints as expected values
109 // for functions returning any of unsigned {int,long} or size_t
111 assertEquals(int expected
,
113 CppUnit::SourceLine sourceLine
,
114 const std::string
& message
)
116 assertEquals(unsigned(expected
), actual
, sourceLine
, message
);
120 assertEquals(int expected
,
121 unsigned long actual
,
122 CppUnit::SourceLine sourceLine
,
123 const std::string
& message
)
125 assertEquals(unsigned long(expected
), actual
, sourceLine
, message
);
128 // we also need this one to resolve ambiguity in the tests comparing unsigned
129 // short (e.g. wxDateTime_t returned by several wxDateTime methods) with
130 // literal integer constants
132 assertEquals(int expected
,
133 unsigned short actual
,
134 CppUnit::SourceLine sourceLine
,
135 const std::string
& message
)
137 assertEquals(unsigned short(expected
), actual
, sourceLine
, message
);
142 // Use this macro to compare a wxArrayString with the pipe-separated elements
143 // of the given string
145 // NB: it's a macro and not a function to have the correct line numbers in the
146 // test failure messages
147 #define WX_ASSERT_STRARRAY_EQUAL(s, a) \
149 wxArrayString expected(wxSplit(s, '|', '\0')); \
151 CPPUNIT_ASSERT_EQUAL( expected.size(), a.size() ); \
153 for ( size_t n = 0; n < a.size(); n++ ) \
155 CPPUNIT_ASSERT_EQUAL( expected[n], a[n] ); \
159 // Use this macro to assert with the given formatted message (it should contain
160 // the format string and arguments in a separate pair of parentheses)
161 #define WX_ASSERT_MESSAGE(msg, cond) \
162 CPPUNIT_ASSERT_MESSAGE(std::string(wxString::Format msg .mb_str()), (cond))
164 ///////////////////////////////////////////////////////////////////////////////
165 // define stream inserter for wxString if it's not defined in the main library,
166 // we need it to output the test failures involving wxString
167 #if !wxUSE_STD_IOSTREAM
169 #include "wx/string.h"
173 inline std::ostream
& operator<<(std::ostream
& o
, const wxString
& s
)
176 return o
<< (const char *)wxSafeConvertWX2MB(s
.wc_str());
178 return o
<< s
.c_str();
182 // VC6 doesn't provide overloads for operator<<(__int64) in its stream classes
183 // so do it ourselves
184 #if defined(__VISUALC6__) && defined(wxLongLong_t)
186 #include "wx/longlong.h"
188 inline std::ostream
& operator<<(std::ostream
& ostr
, wxLongLong_t ll
)
190 ostr
<< wxLongLong(ll
).ToString();
195 inline std::ostream
& operator<<(std::ostream
& ostr
, unsigned wxLongLong_t llu
)
197 ostr
<< wxULongLong(llu
).ToString();
202 #endif // VC6 && wxLongLong_t
204 #endif // !wxUSE_STD_IOSTREAM
206 ///////////////////////////////////////////////////////////////////////////////
207 // Some more compiler warning tweaking and auto linking.
215 #pragma warning(default:4702)
218 // for VC++ automatically link in cppunit library
221 #pragma comment(lib, "cppunit.lib")
223 #pragma comment(lib, "cppunitd.lib")
224 #endif // Release/Debug
227 #endif // _WX_CPPUNIT_H_