uia 0.0.5 → 0.0.5.1
Sign up to get free protection for your applications and to get access to all the features.
- data/ChangeLog +5 -1
- data/lib/uia/version.rb +1 -1
- data/uia.gemspec +3 -1
- metadata +1 -48
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-actions.h +0 -1078
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-cardinalities.h +0 -147
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-actions.h +0 -2415
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-actions.h.pump +0 -821
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-function-mockers.h +0 -991
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-function-mockers.h.pump +0 -265
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-matchers.h +0 -2190
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-matchers.h.pump +0 -674
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-nice-strict.h +0 -397
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-generated-nice-strict.h.pump +0 -161
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-matchers.h +0 -3986
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-more-actions.h +0 -233
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-more-matchers.h +0 -58
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock-spec-builders.h +0 -1791
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/gmock.h +0 -94
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/internal/gmock-generated-internal-utils.h +0 -279
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/internal/gmock-generated-internal-utils.h.pump +0 -136
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/internal/gmock-internal-utils.h +0 -498
- data/ext/UiaDll/UiaDll.Test/gmock/include/gmock/internal/gmock-port.h +0 -78
- data/ext/UiaDll/UiaDll.Test/gmock/lib/gmock.lib +0 -0
- data/ext/UiaDll/UiaDll.Test/gmock/lib/gmockd.lib +0 -0
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-death-test.h +0 -294
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-message.h +0 -250
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-param-test.h +0 -1421
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-param-test.h.pump +0 -487
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-printers.h +0 -855
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-spi.h +0 -232
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-test-part.h +0 -179
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest-typed-test.h +0 -259
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest.h +0 -2291
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest_pred_impl.h +0 -358
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/gtest_prod.h +0 -58
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-death-test-internal.h +0 -319
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-filepath.h +0 -206
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-internal.h +0 -1158
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-linked_ptr.h +0 -233
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-param-util-generated.h +0 -5143
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-param-util-generated.h.pump +0 -301
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-param-util.h +0 -619
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-port.h +0 -1947
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-string.h +0 -167
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-tuple.h +0 -1012
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-tuple.h.pump +0 -339
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-type-util.h +0 -3331
- data/ext/UiaDll/UiaDll.Test/gtest/include/gtest/internal/gtest-type-util.h.pump +0 -297
- data/ext/UiaDll/UiaDll.Test/gtest/lib/gtest.lib +0 -0
- data/ext/UiaDll/UiaDll.Test/gtest/lib/gtestd.lib +0 -0
@@ -1,2291 +0,0 @@
|
|
1
|
-
// Copyright 2005, Google Inc.
|
2
|
-
// All rights reserved.
|
3
|
-
//
|
4
|
-
// Redistribution and use in source and binary forms, with or without
|
5
|
-
// modification, are permitted provided that the following conditions are
|
6
|
-
// met:
|
7
|
-
//
|
8
|
-
// * Redistributions of source code must retain the above copyright
|
9
|
-
// notice, this list of conditions and the following disclaimer.
|
10
|
-
// * Redistributions in binary form must reproduce the above
|
11
|
-
// copyright notice, this list of conditions and the following disclaimer
|
12
|
-
// in the documentation and/or other materials provided with the
|
13
|
-
// distribution.
|
14
|
-
// * Neither the name of Google Inc. nor the names of its
|
15
|
-
// contributors may be used to endorse or promote products derived from
|
16
|
-
// this software without specific prior written permission.
|
17
|
-
//
|
18
|
-
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
19
|
-
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
20
|
-
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
21
|
-
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
22
|
-
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
23
|
-
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
24
|
-
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
25
|
-
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
26
|
-
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
27
|
-
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
28
|
-
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
29
|
-
//
|
30
|
-
// Author: wan@google.com (Zhanyong Wan)
|
31
|
-
//
|
32
|
-
// The Google C++ Testing Framework (Google Test)
|
33
|
-
//
|
34
|
-
// This header file defines the public API for Google Test. It should be
|
35
|
-
// included by any test program that uses Google Test.
|
36
|
-
//
|
37
|
-
// IMPORTANT NOTE: Due to limitation of the C++ language, we have to
|
38
|
-
// leave some internal implementation details in this header file.
|
39
|
-
// They are clearly marked by comments like this:
|
40
|
-
//
|
41
|
-
// // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
42
|
-
//
|
43
|
-
// Such code is NOT meant to be used by a user directly, and is subject
|
44
|
-
// to CHANGE WITHOUT NOTICE. Therefore DO NOT DEPEND ON IT in a user
|
45
|
-
// program!
|
46
|
-
//
|
47
|
-
// Acknowledgment: Google Test borrowed the idea of automatic test
|
48
|
-
// registration from Barthelemy Dagenais' (barthelemy@prologique.com)
|
49
|
-
// easyUnit framework.
|
50
|
-
|
51
|
-
#ifndef GTEST_INCLUDE_GTEST_GTEST_H_
|
52
|
-
#define GTEST_INCLUDE_GTEST_GTEST_H_
|
53
|
-
|
54
|
-
#include <limits>
|
55
|
-
#include <ostream>
|
56
|
-
#include <vector>
|
57
|
-
|
58
|
-
#include "gtest/internal/gtest-internal.h"
|
59
|
-
#include "gtest/internal/gtest-string.h"
|
60
|
-
#include "gtest/gtest-death-test.h"
|
61
|
-
#include "gtest/gtest-message.h"
|
62
|
-
#include "gtest/gtest-param-test.h"
|
63
|
-
#include "gtest/gtest-printers.h"
|
64
|
-
#include "gtest/gtest_prod.h"
|
65
|
-
#include "gtest/gtest-test-part.h"
|
66
|
-
#include "gtest/gtest-typed-test.h"
|
67
|
-
|
68
|
-
// Depending on the platform, different string classes are available.
|
69
|
-
// On Linux, in addition to ::std::string, Google also makes use of
|
70
|
-
// class ::string, which has the same interface as ::std::string, but
|
71
|
-
// has a different implementation.
|
72
|
-
//
|
73
|
-
// The user can define GTEST_HAS_GLOBAL_STRING to 1 to indicate that
|
74
|
-
// ::string is available AND is a distinct type to ::std::string, or
|
75
|
-
// define it to 0 to indicate otherwise.
|
76
|
-
//
|
77
|
-
// If the user's ::std::string and ::string are the same class due to
|
78
|
-
// aliasing, he should define GTEST_HAS_GLOBAL_STRING to 0.
|
79
|
-
//
|
80
|
-
// If the user doesn't define GTEST_HAS_GLOBAL_STRING, it is defined
|
81
|
-
// heuristically.
|
82
|
-
|
83
|
-
namespace testing {
|
84
|
-
|
85
|
-
// Declares the flags.
|
86
|
-
|
87
|
-
// This flag temporary enables the disabled tests.
|
88
|
-
GTEST_DECLARE_bool_(also_run_disabled_tests);
|
89
|
-
|
90
|
-
// This flag brings the debugger on an assertion failure.
|
91
|
-
GTEST_DECLARE_bool_(break_on_failure);
|
92
|
-
|
93
|
-
// This flag controls whether Google Test catches all test-thrown exceptions
|
94
|
-
// and logs them as failures.
|
95
|
-
GTEST_DECLARE_bool_(catch_exceptions);
|
96
|
-
|
97
|
-
// This flag enables using colors in terminal output. Available values are
|
98
|
-
// "yes" to enable colors, "no" (disable colors), or "auto" (the default)
|
99
|
-
// to let Google Test decide.
|
100
|
-
GTEST_DECLARE_string_(color);
|
101
|
-
|
102
|
-
// This flag sets up the filter to select by name using a glob pattern
|
103
|
-
// the tests to run. If the filter is not given all tests are executed.
|
104
|
-
GTEST_DECLARE_string_(filter);
|
105
|
-
|
106
|
-
// This flag causes the Google Test to list tests. None of the tests listed
|
107
|
-
// are actually run if the flag is provided.
|
108
|
-
GTEST_DECLARE_bool_(list_tests);
|
109
|
-
|
110
|
-
// This flag controls whether Google Test emits a detailed XML report to a file
|
111
|
-
// in addition to its normal textual output.
|
112
|
-
GTEST_DECLARE_string_(output);
|
113
|
-
|
114
|
-
// This flags control whether Google Test prints the elapsed time for each
|
115
|
-
// test.
|
116
|
-
GTEST_DECLARE_bool_(print_time);
|
117
|
-
|
118
|
-
// This flag specifies the random number seed.
|
119
|
-
GTEST_DECLARE_int32_(random_seed);
|
120
|
-
|
121
|
-
// This flag sets how many times the tests are repeated. The default value
|
122
|
-
// is 1. If the value is -1 the tests are repeating forever.
|
123
|
-
GTEST_DECLARE_int32_(repeat);
|
124
|
-
|
125
|
-
// This flag controls whether Google Test includes Google Test internal
|
126
|
-
// stack frames in failure stack traces.
|
127
|
-
GTEST_DECLARE_bool_(show_internal_stack_frames);
|
128
|
-
|
129
|
-
// When this flag is specified, tests' order is randomized on every iteration.
|
130
|
-
GTEST_DECLARE_bool_(shuffle);
|
131
|
-
|
132
|
-
// This flag specifies the maximum number of stack frames to be
|
133
|
-
// printed in a failure message.
|
134
|
-
GTEST_DECLARE_int32_(stack_trace_depth);
|
135
|
-
|
136
|
-
// When this flag is specified, a failed assertion will throw an
|
137
|
-
// exception if exceptions are enabled, or exit the program with a
|
138
|
-
// non-zero code otherwise.
|
139
|
-
GTEST_DECLARE_bool_(throw_on_failure);
|
140
|
-
|
141
|
-
// When this flag is set with a "host:port" string, on supported
|
142
|
-
// platforms test results are streamed to the specified port on
|
143
|
-
// the specified host machine.
|
144
|
-
GTEST_DECLARE_string_(stream_result_to);
|
145
|
-
|
146
|
-
// The upper limit for valid stack trace depths.
|
147
|
-
const int kMaxStackTraceDepth = 100;
|
148
|
-
|
149
|
-
namespace internal {
|
150
|
-
|
151
|
-
class AssertHelper;
|
152
|
-
class DefaultGlobalTestPartResultReporter;
|
153
|
-
class ExecDeathTest;
|
154
|
-
class NoExecDeathTest;
|
155
|
-
class FinalSuccessChecker;
|
156
|
-
class GTestFlagSaver;
|
157
|
-
class StreamingListenerTest;
|
158
|
-
class TestResultAccessor;
|
159
|
-
class TestEventListenersAccessor;
|
160
|
-
class TestEventRepeater;
|
161
|
-
class UnitTestRecordPropertyTestHelper;
|
162
|
-
class WindowsDeathTest;
|
163
|
-
class UnitTestImpl* GetUnitTestImpl();
|
164
|
-
void ReportFailureInUnknownLocation(TestPartResult::Type result_type,
|
165
|
-
const std::string& message);
|
166
|
-
|
167
|
-
} // namespace internal
|
168
|
-
|
169
|
-
// The friend relationship of some of these classes is cyclic.
|
170
|
-
// If we don't forward declare them the compiler might confuse the classes
|
171
|
-
// in friendship clauses with same named classes on the scope.
|
172
|
-
class Test;
|
173
|
-
class TestCase;
|
174
|
-
class TestInfo;
|
175
|
-
class UnitTest;
|
176
|
-
|
177
|
-
// A class for indicating whether an assertion was successful. When
|
178
|
-
// the assertion wasn't successful, the AssertionResult object
|
179
|
-
// remembers a non-empty message that describes how it failed.
|
180
|
-
//
|
181
|
-
// To create an instance of this class, use one of the factory functions
|
182
|
-
// (AssertionSuccess() and AssertionFailure()).
|
183
|
-
//
|
184
|
-
// This class is useful for two purposes:
|
185
|
-
// 1. Defining predicate functions to be used with Boolean test assertions
|
186
|
-
// EXPECT_TRUE/EXPECT_FALSE and their ASSERT_ counterparts
|
187
|
-
// 2. Defining predicate-format functions to be
|
188
|
-
// used with predicate assertions (ASSERT_PRED_FORMAT*, etc).
|
189
|
-
//
|
190
|
-
// For example, if you define IsEven predicate:
|
191
|
-
//
|
192
|
-
// testing::AssertionResult IsEven(int n) {
|
193
|
-
// if ((n % 2) == 0)
|
194
|
-
// return testing::AssertionSuccess();
|
195
|
-
// else
|
196
|
-
// return testing::AssertionFailure() << n << " is odd";
|
197
|
-
// }
|
198
|
-
//
|
199
|
-
// Then the failed expectation EXPECT_TRUE(IsEven(Fib(5)))
|
200
|
-
// will print the message
|
201
|
-
//
|
202
|
-
// Value of: IsEven(Fib(5))
|
203
|
-
// Actual: false (5 is odd)
|
204
|
-
// Expected: true
|
205
|
-
//
|
206
|
-
// instead of a more opaque
|
207
|
-
//
|
208
|
-
// Value of: IsEven(Fib(5))
|
209
|
-
// Actual: false
|
210
|
-
// Expected: true
|
211
|
-
//
|
212
|
-
// in case IsEven is a simple Boolean predicate.
|
213
|
-
//
|
214
|
-
// If you expect your predicate to be reused and want to support informative
|
215
|
-
// messages in EXPECT_FALSE and ASSERT_FALSE (negative assertions show up
|
216
|
-
// about half as often as positive ones in our tests), supply messages for
|
217
|
-
// both success and failure cases:
|
218
|
-
//
|
219
|
-
// testing::AssertionResult IsEven(int n) {
|
220
|
-
// if ((n % 2) == 0)
|
221
|
-
// return testing::AssertionSuccess() << n << " is even";
|
222
|
-
// else
|
223
|
-
// return testing::AssertionFailure() << n << " is odd";
|
224
|
-
// }
|
225
|
-
//
|
226
|
-
// Then a statement EXPECT_FALSE(IsEven(Fib(6))) will print
|
227
|
-
//
|
228
|
-
// Value of: IsEven(Fib(6))
|
229
|
-
// Actual: true (8 is even)
|
230
|
-
// Expected: false
|
231
|
-
//
|
232
|
-
// NB: Predicates that support negative Boolean assertions have reduced
|
233
|
-
// performance in positive ones so be careful not to use them in tests
|
234
|
-
// that have lots (tens of thousands) of positive Boolean assertions.
|
235
|
-
//
|
236
|
-
// To use this class with EXPECT_PRED_FORMAT assertions such as:
|
237
|
-
//
|
238
|
-
// // Verifies that Foo() returns an even number.
|
239
|
-
// EXPECT_PRED_FORMAT1(IsEven, Foo());
|
240
|
-
//
|
241
|
-
// you need to define:
|
242
|
-
//
|
243
|
-
// testing::AssertionResult IsEven(const char* expr, int n) {
|
244
|
-
// if ((n % 2) == 0)
|
245
|
-
// return testing::AssertionSuccess();
|
246
|
-
// else
|
247
|
-
// return testing::AssertionFailure()
|
248
|
-
// << "Expected: " << expr << " is even\n Actual: it's " << n;
|
249
|
-
// }
|
250
|
-
//
|
251
|
-
// If Foo() returns 5, you will see the following message:
|
252
|
-
//
|
253
|
-
// Expected: Foo() is even
|
254
|
-
// Actual: it's 5
|
255
|
-
//
|
256
|
-
class GTEST_API_ AssertionResult {
|
257
|
-
public:
|
258
|
-
// Copy constructor.
|
259
|
-
// Used in EXPECT_TRUE/FALSE(assertion_result).
|
260
|
-
AssertionResult(const AssertionResult& other);
|
261
|
-
// Used in the EXPECT_TRUE/FALSE(bool_expression).
|
262
|
-
explicit AssertionResult(bool success) : success_(success) {}
|
263
|
-
|
264
|
-
// Returns true iff the assertion succeeded.
|
265
|
-
operator bool() const { return success_; } // NOLINT
|
266
|
-
|
267
|
-
// Returns the assertion's negation. Used with EXPECT/ASSERT_FALSE.
|
268
|
-
AssertionResult operator!() const;
|
269
|
-
|
270
|
-
// Returns the text streamed into this AssertionResult. Test assertions
|
271
|
-
// use it when they fail (i.e., the predicate's outcome doesn't match the
|
272
|
-
// assertion's expectation). When nothing has been streamed into the
|
273
|
-
// object, returns an empty string.
|
274
|
-
const char* message() const {
|
275
|
-
return message_.get() != NULL ? message_->c_str() : "";
|
276
|
-
}
|
277
|
-
// TODO(vladl@google.com): Remove this after making sure no clients use it.
|
278
|
-
// Deprecated; please use message() instead.
|
279
|
-
const char* failure_message() const { return message(); }
|
280
|
-
|
281
|
-
// Streams a custom failure message into this object.
|
282
|
-
template <typename T> AssertionResult& operator<<(const T& value) {
|
283
|
-
AppendMessage(Message() << value);
|
284
|
-
return *this;
|
285
|
-
}
|
286
|
-
|
287
|
-
// Allows streaming basic output manipulators such as endl or flush into
|
288
|
-
// this object.
|
289
|
-
AssertionResult& operator<<(
|
290
|
-
::std::ostream& (*basic_manipulator)(::std::ostream& stream)) {
|
291
|
-
AppendMessage(Message() << basic_manipulator);
|
292
|
-
return *this;
|
293
|
-
}
|
294
|
-
|
295
|
-
private:
|
296
|
-
// Appends the contents of message to message_.
|
297
|
-
void AppendMessage(const Message& a_message) {
|
298
|
-
if (message_.get() == NULL)
|
299
|
-
message_.reset(new ::std::string);
|
300
|
-
message_->append(a_message.GetString().c_str());
|
301
|
-
}
|
302
|
-
|
303
|
-
// Stores result of the assertion predicate.
|
304
|
-
bool success_;
|
305
|
-
// Stores the message describing the condition in case the expectation
|
306
|
-
// construct is not satisfied with the predicate's outcome.
|
307
|
-
// Referenced via a pointer to avoid taking too much stack frame space
|
308
|
-
// with test assertions.
|
309
|
-
internal::scoped_ptr< ::std::string> message_;
|
310
|
-
|
311
|
-
GTEST_DISALLOW_ASSIGN_(AssertionResult);
|
312
|
-
};
|
313
|
-
|
314
|
-
// Makes a successful assertion result.
|
315
|
-
GTEST_API_ AssertionResult AssertionSuccess();
|
316
|
-
|
317
|
-
// Makes a failed assertion result.
|
318
|
-
GTEST_API_ AssertionResult AssertionFailure();
|
319
|
-
|
320
|
-
// Makes a failed assertion result with the given failure message.
|
321
|
-
// Deprecated; use AssertionFailure() << msg.
|
322
|
-
GTEST_API_ AssertionResult AssertionFailure(const Message& msg);
|
323
|
-
|
324
|
-
// The abstract class that all tests inherit from.
|
325
|
-
//
|
326
|
-
// In Google Test, a unit test program contains one or many TestCases, and
|
327
|
-
// each TestCase contains one or many Tests.
|
328
|
-
//
|
329
|
-
// When you define a test using the TEST macro, you don't need to
|
330
|
-
// explicitly derive from Test - the TEST macro automatically does
|
331
|
-
// this for you.
|
332
|
-
//
|
333
|
-
// The only time you derive from Test is when defining a test fixture
|
334
|
-
// to be used a TEST_F. For example:
|
335
|
-
//
|
336
|
-
// class FooTest : public testing::Test {
|
337
|
-
// protected:
|
338
|
-
// virtual void SetUp() { ... }
|
339
|
-
// virtual void TearDown() { ... }
|
340
|
-
// ...
|
341
|
-
// };
|
342
|
-
//
|
343
|
-
// TEST_F(FooTest, Bar) { ... }
|
344
|
-
// TEST_F(FooTest, Baz) { ... }
|
345
|
-
//
|
346
|
-
// Test is not copyable.
|
347
|
-
class GTEST_API_ Test {
|
348
|
-
public:
|
349
|
-
friend class TestInfo;
|
350
|
-
|
351
|
-
// Defines types for pointers to functions that set up and tear down
|
352
|
-
// a test case.
|
353
|
-
typedef internal::SetUpTestCaseFunc SetUpTestCaseFunc;
|
354
|
-
typedef internal::TearDownTestCaseFunc TearDownTestCaseFunc;
|
355
|
-
|
356
|
-
// The d'tor is virtual as we intend to inherit from Test.
|
357
|
-
virtual ~Test();
|
358
|
-
|
359
|
-
// Sets up the stuff shared by all tests in this test case.
|
360
|
-
//
|
361
|
-
// Google Test will call Foo::SetUpTestCase() before running the first
|
362
|
-
// test in test case Foo. Hence a sub-class can define its own
|
363
|
-
// SetUpTestCase() method to shadow the one defined in the super
|
364
|
-
// class.
|
365
|
-
static void SetUpTestCase() {}
|
366
|
-
|
367
|
-
// Tears down the stuff shared by all tests in this test case.
|
368
|
-
//
|
369
|
-
// Google Test will call Foo::TearDownTestCase() after running the last
|
370
|
-
// test in test case Foo. Hence a sub-class can define its own
|
371
|
-
// TearDownTestCase() method to shadow the one defined in the super
|
372
|
-
// class.
|
373
|
-
static void TearDownTestCase() {}
|
374
|
-
|
375
|
-
// Returns true iff the current test has a fatal failure.
|
376
|
-
static bool HasFatalFailure();
|
377
|
-
|
378
|
-
// Returns true iff the current test has a non-fatal failure.
|
379
|
-
static bool HasNonfatalFailure();
|
380
|
-
|
381
|
-
// Returns true iff the current test has a (either fatal or
|
382
|
-
// non-fatal) failure.
|
383
|
-
static bool HasFailure() { return HasFatalFailure() || HasNonfatalFailure(); }
|
384
|
-
|
385
|
-
// Logs a property for the current test, test case, or for the entire
|
386
|
-
// invocation of the test program when used outside of the context of a
|
387
|
-
// test case. Only the last value for a given key is remembered. These
|
388
|
-
// are public static so they can be called from utility functions that are
|
389
|
-
// not members of the test fixture. Calls to RecordProperty made during
|
390
|
-
// lifespan of the test (from the moment its constructor starts to the
|
391
|
-
// moment its destructor finishes) will be output in XML as attributes of
|
392
|
-
// the <testcase> element. Properties recorded from fixture's
|
393
|
-
// SetUpTestCase or TearDownTestCase are logged as attributes of the
|
394
|
-
// corresponding <testsuite> element. Calls to RecordProperty made in the
|
395
|
-
// global context (before or after invocation of RUN_ALL_TESTS and from
|
396
|
-
// SetUp/TearDown method of Environment objects registered with Google
|
397
|
-
// Test) will be output as attributes of the <testsuites> element.
|
398
|
-
static void RecordProperty(const std::string& key, const std::string& value);
|
399
|
-
static void RecordProperty(const std::string& key, int value);
|
400
|
-
|
401
|
-
protected:
|
402
|
-
// Creates a Test object.
|
403
|
-
Test();
|
404
|
-
|
405
|
-
// Sets up the test fixture.
|
406
|
-
virtual void SetUp();
|
407
|
-
|
408
|
-
// Tears down the test fixture.
|
409
|
-
virtual void TearDown();
|
410
|
-
|
411
|
-
private:
|
412
|
-
// Returns true iff the current test has the same fixture class as
|
413
|
-
// the first test in the current test case.
|
414
|
-
static bool HasSameFixtureClass();
|
415
|
-
|
416
|
-
// Runs the test after the test fixture has been set up.
|
417
|
-
//
|
418
|
-
// A sub-class must implement this to define the test logic.
|
419
|
-
//
|
420
|
-
// DO NOT OVERRIDE THIS FUNCTION DIRECTLY IN A USER PROGRAM.
|
421
|
-
// Instead, use the TEST or TEST_F macro.
|
422
|
-
virtual void TestBody() = 0;
|
423
|
-
|
424
|
-
// Sets up, executes, and tears down the test.
|
425
|
-
void Run();
|
426
|
-
|
427
|
-
// Deletes self. We deliberately pick an unusual name for this
|
428
|
-
// internal method to avoid clashing with names used in user TESTs.
|
429
|
-
void DeleteSelf_() { delete this; }
|
430
|
-
|
431
|
-
// Uses a GTestFlagSaver to save and restore all Google Test flags.
|
432
|
-
const internal::GTestFlagSaver* const gtest_flag_saver_;
|
433
|
-
|
434
|
-
// Often a user mis-spells SetUp() as Setup() and spends a long time
|
435
|
-
// wondering why it is never called by Google Test. The declaration of
|
436
|
-
// the following method is solely for catching such an error at
|
437
|
-
// compile time:
|
438
|
-
//
|
439
|
-
// - The return type is deliberately chosen to be not void, so it
|
440
|
-
// will be a conflict if a user declares void Setup() in his test
|
441
|
-
// fixture.
|
442
|
-
//
|
443
|
-
// - This method is private, so it will be another compiler error
|
444
|
-
// if a user calls it from his test fixture.
|
445
|
-
//
|
446
|
-
// DO NOT OVERRIDE THIS FUNCTION.
|
447
|
-
//
|
448
|
-
// If you see an error about overriding the following function or
|
449
|
-
// about it being private, you have mis-spelled SetUp() as Setup().
|
450
|
-
struct Setup_should_be_spelled_SetUp {};
|
451
|
-
virtual Setup_should_be_spelled_SetUp* Setup() { return NULL; }
|
452
|
-
|
453
|
-
// We disallow copying Tests.
|
454
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(Test);
|
455
|
-
};
|
456
|
-
|
457
|
-
typedef internal::TimeInMillis TimeInMillis;
|
458
|
-
|
459
|
-
// A copyable object representing a user specified test property which can be
|
460
|
-
// output as a key/value string pair.
|
461
|
-
//
|
462
|
-
// Don't inherit from TestProperty as its destructor is not virtual.
|
463
|
-
class TestProperty {
|
464
|
-
public:
|
465
|
-
// C'tor. TestProperty does NOT have a default constructor.
|
466
|
-
// Always use this constructor (with parameters) to create a
|
467
|
-
// TestProperty object.
|
468
|
-
TestProperty(const std::string& a_key, const std::string& a_value) :
|
469
|
-
key_(a_key), value_(a_value) {
|
470
|
-
}
|
471
|
-
|
472
|
-
// Gets the user supplied key.
|
473
|
-
const char* key() const {
|
474
|
-
return key_.c_str();
|
475
|
-
}
|
476
|
-
|
477
|
-
// Gets the user supplied value.
|
478
|
-
const char* value() const {
|
479
|
-
return value_.c_str();
|
480
|
-
}
|
481
|
-
|
482
|
-
// Sets a new value, overriding the one supplied in the constructor.
|
483
|
-
void SetValue(const std::string& new_value) {
|
484
|
-
value_ = new_value;
|
485
|
-
}
|
486
|
-
|
487
|
-
private:
|
488
|
-
// The key supplied by the user.
|
489
|
-
std::string key_;
|
490
|
-
// The value supplied by the user.
|
491
|
-
std::string value_;
|
492
|
-
};
|
493
|
-
|
494
|
-
// The result of a single Test. This includes a list of
|
495
|
-
// TestPartResults, a list of TestProperties, a count of how many
|
496
|
-
// death tests there are in the Test, and how much time it took to run
|
497
|
-
// the Test.
|
498
|
-
//
|
499
|
-
// TestResult is not copyable.
|
500
|
-
class GTEST_API_ TestResult {
|
501
|
-
public:
|
502
|
-
// Creates an empty TestResult.
|
503
|
-
TestResult();
|
504
|
-
|
505
|
-
// D'tor. Do not inherit from TestResult.
|
506
|
-
~TestResult();
|
507
|
-
|
508
|
-
// Gets the number of all test parts. This is the sum of the number
|
509
|
-
// of successful test parts and the number of failed test parts.
|
510
|
-
int total_part_count() const;
|
511
|
-
|
512
|
-
// Returns the number of the test properties.
|
513
|
-
int test_property_count() const;
|
514
|
-
|
515
|
-
// Returns true iff the test passed (i.e. no test part failed).
|
516
|
-
bool Passed() const { return !Failed(); }
|
517
|
-
|
518
|
-
// Returns true iff the test failed.
|
519
|
-
bool Failed() const;
|
520
|
-
|
521
|
-
// Returns true iff the test fatally failed.
|
522
|
-
bool HasFatalFailure() const;
|
523
|
-
|
524
|
-
// Returns true iff the test has a non-fatal failure.
|
525
|
-
bool HasNonfatalFailure() const;
|
526
|
-
|
527
|
-
// Returns the elapsed time, in milliseconds.
|
528
|
-
TimeInMillis elapsed_time() const { return elapsed_time_; }
|
529
|
-
|
530
|
-
// Returns the i-th test part result among all the results. i can range
|
531
|
-
// from 0 to test_property_count() - 1. If i is not in that range, aborts
|
532
|
-
// the program.
|
533
|
-
const TestPartResult& GetTestPartResult(int i) const;
|
534
|
-
|
535
|
-
// Returns the i-th test property. i can range from 0 to
|
536
|
-
// test_property_count() - 1. If i is not in that range, aborts the
|
537
|
-
// program.
|
538
|
-
const TestProperty& GetTestProperty(int i) const;
|
539
|
-
|
540
|
-
private:
|
541
|
-
friend class TestInfo;
|
542
|
-
friend class TestCase;
|
543
|
-
friend class UnitTest;
|
544
|
-
friend class internal::DefaultGlobalTestPartResultReporter;
|
545
|
-
friend class internal::ExecDeathTest;
|
546
|
-
friend class internal::TestResultAccessor;
|
547
|
-
friend class internal::UnitTestImpl;
|
548
|
-
friend class internal::WindowsDeathTest;
|
549
|
-
|
550
|
-
// Gets the vector of TestPartResults.
|
551
|
-
const std::vector<TestPartResult>& test_part_results() const {
|
552
|
-
return test_part_results_;
|
553
|
-
}
|
554
|
-
|
555
|
-
// Gets the vector of TestProperties.
|
556
|
-
const std::vector<TestProperty>& test_properties() const {
|
557
|
-
return test_properties_;
|
558
|
-
}
|
559
|
-
|
560
|
-
// Sets the elapsed time.
|
561
|
-
void set_elapsed_time(TimeInMillis elapsed) { elapsed_time_ = elapsed; }
|
562
|
-
|
563
|
-
// Adds a test property to the list. The property is validated and may add
|
564
|
-
// a non-fatal failure if invalid (e.g., if it conflicts with reserved
|
565
|
-
// key names). If a property is already recorded for the same key, the
|
566
|
-
// value will be updated, rather than storing multiple values for the same
|
567
|
-
// key. xml_element specifies the element for which the property is being
|
568
|
-
// recorded and is used for validation.
|
569
|
-
void RecordProperty(const std::string& xml_element,
|
570
|
-
const TestProperty& test_property);
|
571
|
-
|
572
|
-
// Adds a failure if the key is a reserved attribute of Google Test
|
573
|
-
// testcase tags. Returns true if the property is valid.
|
574
|
-
// TODO(russr): Validate attribute names are legal and human readable.
|
575
|
-
static bool ValidateTestProperty(const std::string& xml_element,
|
576
|
-
const TestProperty& test_property);
|
577
|
-
|
578
|
-
// Adds a test part result to the list.
|
579
|
-
void AddTestPartResult(const TestPartResult& test_part_result);
|
580
|
-
|
581
|
-
// Returns the death test count.
|
582
|
-
int death_test_count() const { return death_test_count_; }
|
583
|
-
|
584
|
-
// Increments the death test count, returning the new count.
|
585
|
-
int increment_death_test_count() { return ++death_test_count_; }
|
586
|
-
|
587
|
-
// Clears the test part results.
|
588
|
-
void ClearTestPartResults();
|
589
|
-
|
590
|
-
// Clears the object.
|
591
|
-
void Clear();
|
592
|
-
|
593
|
-
// Protects mutable state of the property vector and of owned
|
594
|
-
// properties, whose values may be updated.
|
595
|
-
internal::Mutex test_properites_mutex_;
|
596
|
-
|
597
|
-
// The vector of TestPartResults
|
598
|
-
std::vector<TestPartResult> test_part_results_;
|
599
|
-
// The vector of TestProperties
|
600
|
-
std::vector<TestProperty> test_properties_;
|
601
|
-
// Running count of death tests.
|
602
|
-
int death_test_count_;
|
603
|
-
// The elapsed time, in milliseconds.
|
604
|
-
TimeInMillis elapsed_time_;
|
605
|
-
|
606
|
-
// We disallow copying TestResult.
|
607
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(TestResult);
|
608
|
-
}; // class TestResult
|
609
|
-
|
610
|
-
// A TestInfo object stores the following information about a test:
|
611
|
-
//
|
612
|
-
// Test case name
|
613
|
-
// Test name
|
614
|
-
// Whether the test should be run
|
615
|
-
// A function pointer that creates the test object when invoked
|
616
|
-
// Test result
|
617
|
-
//
|
618
|
-
// The constructor of TestInfo registers itself with the UnitTest
|
619
|
-
// singleton such that the RUN_ALL_TESTS() macro knows which tests to
|
620
|
-
// run.
|
621
|
-
class GTEST_API_ TestInfo {
|
622
|
-
public:
|
623
|
-
// Destructs a TestInfo object. This function is not virtual, so
|
624
|
-
// don't inherit from TestInfo.
|
625
|
-
~TestInfo();
|
626
|
-
|
627
|
-
// Returns the test case name.
|
628
|
-
const char* test_case_name() const { return test_case_name_.c_str(); }
|
629
|
-
|
630
|
-
// Returns the test name.
|
631
|
-
const char* name() const { return name_.c_str(); }
|
632
|
-
|
633
|
-
// Returns the name of the parameter type, or NULL if this is not a typed
|
634
|
-
// or a type-parameterized test.
|
635
|
-
const char* type_param() const {
|
636
|
-
if (type_param_.get() != NULL)
|
637
|
-
return type_param_->c_str();
|
638
|
-
return NULL;
|
639
|
-
}
|
640
|
-
|
641
|
-
// Returns the text representation of the value parameter, or NULL if this
|
642
|
-
// is not a value-parameterized test.
|
643
|
-
const char* value_param() const {
|
644
|
-
if (value_param_.get() != NULL)
|
645
|
-
return value_param_->c_str();
|
646
|
-
return NULL;
|
647
|
-
}
|
648
|
-
|
649
|
-
// Returns true if this test should run, that is if the test is not
|
650
|
-
// disabled (or it is disabled but the also_run_disabled_tests flag has
|
651
|
-
// been specified) and its full name matches the user-specified filter.
|
652
|
-
//
|
653
|
-
// Google Test allows the user to filter the tests by their full names.
|
654
|
-
// The full name of a test Bar in test case Foo is defined as
|
655
|
-
// "Foo.Bar". Only the tests that match the filter will run.
|
656
|
-
//
|
657
|
-
// A filter is a colon-separated list of glob (not regex) patterns,
|
658
|
-
// optionally followed by a '-' and a colon-separated list of
|
659
|
-
// negative patterns (tests to exclude). A test is run if it
|
660
|
-
// matches one of the positive patterns and does not match any of
|
661
|
-
// the negative patterns.
|
662
|
-
//
|
663
|
-
// For example, *A*:Foo.* is a filter that matches any string that
|
664
|
-
// contains the character 'A' or starts with "Foo.".
|
665
|
-
bool should_run() const { return should_run_; }
|
666
|
-
|
667
|
-
// Returns true iff this test will appear in the XML report.
|
668
|
-
bool is_reportable() const {
|
669
|
-
// For now, the XML report includes all tests matching the filter.
|
670
|
-
// In the future, we may trim tests that are excluded because of
|
671
|
-
// sharding.
|
672
|
-
return matches_filter_;
|
673
|
-
}
|
674
|
-
|
675
|
-
// Returns the result of the test.
|
676
|
-
const TestResult* result() const { return &result_; }
|
677
|
-
|
678
|
-
private:
|
679
|
-
#if GTEST_HAS_DEATH_TEST
|
680
|
-
friend class internal::DefaultDeathTestFactory;
|
681
|
-
#endif // GTEST_HAS_DEATH_TEST
|
682
|
-
friend class Test;
|
683
|
-
friend class TestCase;
|
684
|
-
friend class internal::UnitTestImpl;
|
685
|
-
friend class internal::StreamingListenerTest;
|
686
|
-
friend TestInfo* internal::MakeAndRegisterTestInfo(
|
687
|
-
const char* test_case_name,
|
688
|
-
const char* name,
|
689
|
-
const char* type_param,
|
690
|
-
const char* value_param,
|
691
|
-
internal::TypeId fixture_class_id,
|
692
|
-
Test::SetUpTestCaseFunc set_up_tc,
|
693
|
-
Test::TearDownTestCaseFunc tear_down_tc,
|
694
|
-
internal::TestFactoryBase* factory);
|
695
|
-
|
696
|
-
// Constructs a TestInfo object. The newly constructed instance assumes
|
697
|
-
// ownership of the factory object.
|
698
|
-
TestInfo(const std::string& test_case_name,
|
699
|
-
const std::string& name,
|
700
|
-
const char* a_type_param, // NULL if not a type-parameterized test
|
701
|
-
const char* a_value_param, // NULL if not a value-parameterized test
|
702
|
-
internal::TypeId fixture_class_id,
|
703
|
-
internal::TestFactoryBase* factory);
|
704
|
-
|
705
|
-
// Increments the number of death tests encountered in this test so
|
706
|
-
// far.
|
707
|
-
int increment_death_test_count() {
|
708
|
-
return result_.increment_death_test_count();
|
709
|
-
}
|
710
|
-
|
711
|
-
// Creates the test object, runs it, records its result, and then
|
712
|
-
// deletes it.
|
713
|
-
void Run();
|
714
|
-
|
715
|
-
static void ClearTestResult(TestInfo* test_info) {
|
716
|
-
test_info->result_.Clear();
|
717
|
-
}
|
718
|
-
|
719
|
-
// These fields are immutable properties of the test.
|
720
|
-
const std::string test_case_name_; // Test case name
|
721
|
-
const std::string name_; // Test name
|
722
|
-
// Name of the parameter type, or NULL if this is not a typed or a
|
723
|
-
// type-parameterized test.
|
724
|
-
const internal::scoped_ptr<const ::std::string> type_param_;
|
725
|
-
// Text representation of the value parameter, or NULL if this is not a
|
726
|
-
// value-parameterized test.
|
727
|
-
const internal::scoped_ptr<const ::std::string> value_param_;
|
728
|
-
const internal::TypeId fixture_class_id_; // ID of the test fixture class
|
729
|
-
bool should_run_; // True iff this test should run
|
730
|
-
bool is_disabled_; // True iff this test is disabled
|
731
|
-
bool matches_filter_; // True if this test matches the
|
732
|
-
// user-specified filter.
|
733
|
-
internal::TestFactoryBase* const factory_; // The factory that creates
|
734
|
-
// the test object
|
735
|
-
|
736
|
-
// This field is mutable and needs to be reset before running the
|
737
|
-
// test for the second time.
|
738
|
-
TestResult result_;
|
739
|
-
|
740
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(TestInfo);
|
741
|
-
};
|
742
|
-
|
743
|
-
// A test case, which consists of a vector of TestInfos.
|
744
|
-
//
|
745
|
-
// TestCase is not copyable.
|
746
|
-
class GTEST_API_ TestCase {
|
747
|
-
public:
|
748
|
-
// Creates a TestCase with the given name.
|
749
|
-
//
|
750
|
-
// TestCase does NOT have a default constructor. Always use this
|
751
|
-
// constructor to create a TestCase object.
|
752
|
-
//
|
753
|
-
// Arguments:
|
754
|
-
//
|
755
|
-
// name: name of the test case
|
756
|
-
// a_type_param: the name of the test's type parameter, or NULL if
|
757
|
-
// this is not a type-parameterized test.
|
758
|
-
// set_up_tc: pointer to the function that sets up the test case
|
759
|
-
// tear_down_tc: pointer to the function that tears down the test case
|
760
|
-
TestCase(const char* name, const char* a_type_param,
|
761
|
-
Test::SetUpTestCaseFunc set_up_tc,
|
762
|
-
Test::TearDownTestCaseFunc tear_down_tc);
|
763
|
-
|
764
|
-
// Destructor of TestCase.
|
765
|
-
virtual ~TestCase();
|
766
|
-
|
767
|
-
// Gets the name of the TestCase.
|
768
|
-
const char* name() const { return name_.c_str(); }
|
769
|
-
|
770
|
-
// Returns the name of the parameter type, or NULL if this is not a
|
771
|
-
// type-parameterized test case.
|
772
|
-
const char* type_param() const {
|
773
|
-
if (type_param_.get() != NULL)
|
774
|
-
return type_param_->c_str();
|
775
|
-
return NULL;
|
776
|
-
}
|
777
|
-
|
778
|
-
// Returns true if any test in this test case should run.
|
779
|
-
bool should_run() const { return should_run_; }
|
780
|
-
|
781
|
-
// Gets the number of successful tests in this test case.
|
782
|
-
int successful_test_count() const;
|
783
|
-
|
784
|
-
// Gets the number of failed tests in this test case.
|
785
|
-
int failed_test_count() const;
|
786
|
-
|
787
|
-
// Gets the number of disabled tests that will be reported in the XML report.
|
788
|
-
int reportable_disabled_test_count() const;
|
789
|
-
|
790
|
-
// Gets the number of disabled tests in this test case.
|
791
|
-
int disabled_test_count() const;
|
792
|
-
|
793
|
-
// Gets the number of tests to be printed in the XML report.
|
794
|
-
int reportable_test_count() const;
|
795
|
-
|
796
|
-
// Get the number of tests in this test case that should run.
|
797
|
-
int test_to_run_count() const;
|
798
|
-
|
799
|
-
// Gets the number of all tests in this test case.
|
800
|
-
int total_test_count() const;
|
801
|
-
|
802
|
-
// Returns true iff the test case passed.
|
803
|
-
bool Passed() const { return !Failed(); }
|
804
|
-
|
805
|
-
// Returns true iff the test case failed.
|
806
|
-
bool Failed() const { return failed_test_count() > 0; }
|
807
|
-
|
808
|
-
// Returns the elapsed time, in milliseconds.
|
809
|
-
TimeInMillis elapsed_time() const { return elapsed_time_; }
|
810
|
-
|
811
|
-
// Returns the i-th test among all the tests. i can range from 0 to
|
812
|
-
// total_test_count() - 1. If i is not in that range, returns NULL.
|
813
|
-
const TestInfo* GetTestInfo(int i) const;
|
814
|
-
|
815
|
-
// Returns the TestResult that holds test properties recorded during
|
816
|
-
// execution of SetUpTestCase and TearDownTestCase.
|
817
|
-
const TestResult& ad_hoc_test_result() const { return ad_hoc_test_result_; }
|
818
|
-
|
819
|
-
private:
|
820
|
-
friend class Test;
|
821
|
-
friend class internal::UnitTestImpl;
|
822
|
-
|
823
|
-
// Gets the (mutable) vector of TestInfos in this TestCase.
|
824
|
-
std::vector<TestInfo*>& test_info_list() { return test_info_list_; }
|
825
|
-
|
826
|
-
// Gets the (immutable) vector of TestInfos in this TestCase.
|
827
|
-
const std::vector<TestInfo*>& test_info_list() const {
|
828
|
-
return test_info_list_;
|
829
|
-
}
|
830
|
-
|
831
|
-
// Returns the i-th test among all the tests. i can range from 0 to
|
832
|
-
// total_test_count() - 1. If i is not in that range, returns NULL.
|
833
|
-
TestInfo* GetMutableTestInfo(int i);
|
834
|
-
|
835
|
-
// Sets the should_run member.
|
836
|
-
void set_should_run(bool should) { should_run_ = should; }
|
837
|
-
|
838
|
-
// Adds a TestInfo to this test case. Will delete the TestInfo upon
|
839
|
-
// destruction of the TestCase object.
|
840
|
-
void AddTestInfo(TestInfo * test_info);
|
841
|
-
|
842
|
-
// Clears the results of all tests in this test case.
|
843
|
-
void ClearResult();
|
844
|
-
|
845
|
-
// Clears the results of all tests in the given test case.
|
846
|
-
static void ClearTestCaseResult(TestCase* test_case) {
|
847
|
-
test_case->ClearResult();
|
848
|
-
}
|
849
|
-
|
850
|
-
// Runs every test in this TestCase.
|
851
|
-
void Run();
|
852
|
-
|
853
|
-
// Runs SetUpTestCase() for this TestCase. This wrapper is needed
|
854
|
-
// for catching exceptions thrown from SetUpTestCase().
|
855
|
-
void RunSetUpTestCase() { (*set_up_tc_)(); }
|
856
|
-
|
857
|
-
// Runs TearDownTestCase() for this TestCase. This wrapper is
|
858
|
-
// needed for catching exceptions thrown from TearDownTestCase().
|
859
|
-
void RunTearDownTestCase() { (*tear_down_tc_)(); }
|
860
|
-
|
861
|
-
// Returns true iff test passed.
|
862
|
-
static bool TestPassed(const TestInfo* test_info) {
|
863
|
-
return test_info->should_run() && test_info->result()->Passed();
|
864
|
-
}
|
865
|
-
|
866
|
-
// Returns true iff test failed.
|
867
|
-
static bool TestFailed(const TestInfo* test_info) {
|
868
|
-
return test_info->should_run() && test_info->result()->Failed();
|
869
|
-
}
|
870
|
-
|
871
|
-
// Returns true iff the test is disabled and will be reported in the XML
|
872
|
-
// report.
|
873
|
-
static bool TestReportableDisabled(const TestInfo* test_info) {
|
874
|
-
return test_info->is_reportable() && test_info->is_disabled_;
|
875
|
-
}
|
876
|
-
|
877
|
-
// Returns true iff test is disabled.
|
878
|
-
static bool TestDisabled(const TestInfo* test_info) {
|
879
|
-
return test_info->is_disabled_;
|
880
|
-
}
|
881
|
-
|
882
|
-
// Returns true iff this test will appear in the XML report.
|
883
|
-
static bool TestReportable(const TestInfo* test_info) {
|
884
|
-
return test_info->is_reportable();
|
885
|
-
}
|
886
|
-
|
887
|
-
// Returns true if the given test should run.
|
888
|
-
static bool ShouldRunTest(const TestInfo* test_info) {
|
889
|
-
return test_info->should_run();
|
890
|
-
}
|
891
|
-
|
892
|
-
// Shuffles the tests in this test case.
|
893
|
-
void ShuffleTests(internal::Random* random);
|
894
|
-
|
895
|
-
// Restores the test order to before the first shuffle.
|
896
|
-
void UnshuffleTests();
|
897
|
-
|
898
|
-
// Name of the test case.
|
899
|
-
std::string name_;
|
900
|
-
// Name of the parameter type, or NULL if this is not a typed or a
|
901
|
-
// type-parameterized test.
|
902
|
-
const internal::scoped_ptr<const ::std::string> type_param_;
|
903
|
-
// The vector of TestInfos in their original order. It owns the
|
904
|
-
// elements in the vector.
|
905
|
-
std::vector<TestInfo*> test_info_list_;
|
906
|
-
// Provides a level of indirection for the test list to allow easy
|
907
|
-
// shuffling and restoring the test order. The i-th element in this
|
908
|
-
// vector is the index of the i-th test in the shuffled test list.
|
909
|
-
std::vector<int> test_indices_;
|
910
|
-
// Pointer to the function that sets up the test case.
|
911
|
-
Test::SetUpTestCaseFunc set_up_tc_;
|
912
|
-
// Pointer to the function that tears down the test case.
|
913
|
-
Test::TearDownTestCaseFunc tear_down_tc_;
|
914
|
-
// True iff any test in this test case should run.
|
915
|
-
bool should_run_;
|
916
|
-
// Elapsed time, in milliseconds.
|
917
|
-
TimeInMillis elapsed_time_;
|
918
|
-
// Holds test properties recorded during execution of SetUpTestCase and
|
919
|
-
// TearDownTestCase.
|
920
|
-
TestResult ad_hoc_test_result_;
|
921
|
-
|
922
|
-
// We disallow copying TestCases.
|
923
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(TestCase);
|
924
|
-
};
|
925
|
-
|
926
|
-
// An Environment object is capable of setting up and tearing down an
|
927
|
-
// environment. The user should subclass this to define his own
|
928
|
-
// environment(s).
|
929
|
-
//
|
930
|
-
// An Environment object does the set-up and tear-down in virtual
|
931
|
-
// methods SetUp() and TearDown() instead of the constructor and the
|
932
|
-
// destructor, as:
|
933
|
-
//
|
934
|
-
// 1. You cannot safely throw from a destructor. This is a problem
|
935
|
-
// as in some cases Google Test is used where exceptions are enabled, and
|
936
|
-
// we may want to implement ASSERT_* using exceptions where they are
|
937
|
-
// available.
|
938
|
-
// 2. You cannot use ASSERT_* directly in a constructor or
|
939
|
-
// destructor.
|
940
|
-
class Environment {
|
941
|
-
public:
|
942
|
-
// The d'tor is virtual as we need to subclass Environment.
|
943
|
-
virtual ~Environment() {}
|
944
|
-
|
945
|
-
// Override this to define how to set up the environment.
|
946
|
-
virtual void SetUp() {}
|
947
|
-
|
948
|
-
// Override this to define how to tear down the environment.
|
949
|
-
virtual void TearDown() {}
|
950
|
-
private:
|
951
|
-
// If you see an error about overriding the following function or
|
952
|
-
// about it being private, you have mis-spelled SetUp() as Setup().
|
953
|
-
struct Setup_should_be_spelled_SetUp {};
|
954
|
-
virtual Setup_should_be_spelled_SetUp* Setup() { return NULL; }
|
955
|
-
};
|
956
|
-
|
957
|
-
// The interface for tracing execution of tests. The methods are organized in
|
958
|
-
// the order the corresponding events are fired.
|
959
|
-
class TestEventListener {
|
960
|
-
public:
|
961
|
-
virtual ~TestEventListener() {}
|
962
|
-
|
963
|
-
// Fired before any test activity starts.
|
964
|
-
virtual void OnTestProgramStart(const UnitTest& unit_test) = 0;
|
965
|
-
|
966
|
-
// Fired before each iteration of tests starts. There may be more than
|
967
|
-
// one iteration if GTEST_FLAG(repeat) is set. iteration is the iteration
|
968
|
-
// index, starting from 0.
|
969
|
-
virtual void OnTestIterationStart(const UnitTest& unit_test,
|
970
|
-
int iteration) = 0;
|
971
|
-
|
972
|
-
// Fired before environment set-up for each iteration of tests starts.
|
973
|
-
virtual void OnEnvironmentsSetUpStart(const UnitTest& unit_test) = 0;
|
974
|
-
|
975
|
-
// Fired after environment set-up for each iteration of tests ends.
|
976
|
-
virtual void OnEnvironmentsSetUpEnd(const UnitTest& unit_test) = 0;
|
977
|
-
|
978
|
-
// Fired before the test case starts.
|
979
|
-
virtual void OnTestCaseStart(const TestCase& test_case) = 0;
|
980
|
-
|
981
|
-
// Fired before the test starts.
|
982
|
-
virtual void OnTestStart(const TestInfo& test_info) = 0;
|
983
|
-
|
984
|
-
// Fired after a failed assertion or a SUCCEED() invocation.
|
985
|
-
virtual void OnTestPartResult(const TestPartResult& test_part_result) = 0;
|
986
|
-
|
987
|
-
// Fired after the test ends.
|
988
|
-
virtual void OnTestEnd(const TestInfo& test_info) = 0;
|
989
|
-
|
990
|
-
// Fired after the test case ends.
|
991
|
-
virtual void OnTestCaseEnd(const TestCase& test_case) = 0;
|
992
|
-
|
993
|
-
// Fired before environment tear-down for each iteration of tests starts.
|
994
|
-
virtual void OnEnvironmentsTearDownStart(const UnitTest& unit_test) = 0;
|
995
|
-
|
996
|
-
// Fired after environment tear-down for each iteration of tests ends.
|
997
|
-
virtual void OnEnvironmentsTearDownEnd(const UnitTest& unit_test) = 0;
|
998
|
-
|
999
|
-
// Fired after each iteration of tests finishes.
|
1000
|
-
virtual void OnTestIterationEnd(const UnitTest& unit_test,
|
1001
|
-
int iteration) = 0;
|
1002
|
-
|
1003
|
-
// Fired after all test activities have ended.
|
1004
|
-
virtual void OnTestProgramEnd(const UnitTest& unit_test) = 0;
|
1005
|
-
};
|
1006
|
-
|
1007
|
-
// The convenience class for users who need to override just one or two
|
1008
|
-
// methods and are not concerned that a possible change to a signature of
|
1009
|
-
// the methods they override will not be caught during the build. For
|
1010
|
-
// comments about each method please see the definition of TestEventListener
|
1011
|
-
// above.
|
1012
|
-
class EmptyTestEventListener : public TestEventListener {
|
1013
|
-
public:
|
1014
|
-
virtual void OnTestProgramStart(const UnitTest& /*unit_test*/) {}
|
1015
|
-
virtual void OnTestIterationStart(const UnitTest& /*unit_test*/,
|
1016
|
-
int /*iteration*/) {}
|
1017
|
-
virtual void OnEnvironmentsSetUpStart(const UnitTest& /*unit_test*/) {}
|
1018
|
-
virtual void OnEnvironmentsSetUpEnd(const UnitTest& /*unit_test*/) {}
|
1019
|
-
virtual void OnTestCaseStart(const TestCase& /*test_case*/) {}
|
1020
|
-
virtual void OnTestStart(const TestInfo& /*test_info*/) {}
|
1021
|
-
virtual void OnTestPartResult(const TestPartResult& /*test_part_result*/) {}
|
1022
|
-
virtual void OnTestEnd(const TestInfo& /*test_info*/) {}
|
1023
|
-
virtual void OnTestCaseEnd(const TestCase& /*test_case*/) {}
|
1024
|
-
virtual void OnEnvironmentsTearDownStart(const UnitTest& /*unit_test*/) {}
|
1025
|
-
virtual void OnEnvironmentsTearDownEnd(const UnitTest& /*unit_test*/) {}
|
1026
|
-
virtual void OnTestIterationEnd(const UnitTest& /*unit_test*/,
|
1027
|
-
int /*iteration*/) {}
|
1028
|
-
virtual void OnTestProgramEnd(const UnitTest& /*unit_test*/) {}
|
1029
|
-
};
|
1030
|
-
|
1031
|
-
// TestEventListeners lets users add listeners to track events in Google Test.
|
1032
|
-
class GTEST_API_ TestEventListeners {
|
1033
|
-
public:
|
1034
|
-
TestEventListeners();
|
1035
|
-
~TestEventListeners();
|
1036
|
-
|
1037
|
-
// Appends an event listener to the end of the list. Google Test assumes
|
1038
|
-
// the ownership of the listener (i.e. it will delete the listener when
|
1039
|
-
// the test program finishes).
|
1040
|
-
void Append(TestEventListener* listener);
|
1041
|
-
|
1042
|
-
// Removes the given event listener from the list and returns it. It then
|
1043
|
-
// becomes the caller's responsibility to delete the listener. Returns
|
1044
|
-
// NULL if the listener is not found in the list.
|
1045
|
-
TestEventListener* Release(TestEventListener* listener);
|
1046
|
-
|
1047
|
-
// Returns the standard listener responsible for the default console
|
1048
|
-
// output. Can be removed from the listeners list to shut down default
|
1049
|
-
// console output. Note that removing this object from the listener list
|
1050
|
-
// with Release transfers its ownership to the caller and makes this
|
1051
|
-
// function return NULL the next time.
|
1052
|
-
TestEventListener* default_result_printer() const {
|
1053
|
-
return default_result_printer_;
|
1054
|
-
}
|
1055
|
-
|
1056
|
-
// Returns the standard listener responsible for the default XML output
|
1057
|
-
// controlled by the --gtest_output=xml flag. Can be removed from the
|
1058
|
-
// listeners list by users who want to shut down the default XML output
|
1059
|
-
// controlled by this flag and substitute it with custom one. Note that
|
1060
|
-
// removing this object from the listener list with Release transfers its
|
1061
|
-
// ownership to the caller and makes this function return NULL the next
|
1062
|
-
// time.
|
1063
|
-
TestEventListener* default_xml_generator() const {
|
1064
|
-
return default_xml_generator_;
|
1065
|
-
}
|
1066
|
-
|
1067
|
-
private:
|
1068
|
-
friend class TestCase;
|
1069
|
-
friend class TestInfo;
|
1070
|
-
friend class internal::DefaultGlobalTestPartResultReporter;
|
1071
|
-
friend class internal::NoExecDeathTest;
|
1072
|
-
friend class internal::TestEventListenersAccessor;
|
1073
|
-
friend class internal::UnitTestImpl;
|
1074
|
-
|
1075
|
-
// Returns repeater that broadcasts the TestEventListener events to all
|
1076
|
-
// subscribers.
|
1077
|
-
TestEventListener* repeater();
|
1078
|
-
|
1079
|
-
// Sets the default_result_printer attribute to the provided listener.
|
1080
|
-
// The listener is also added to the listener list and previous
|
1081
|
-
// default_result_printer is removed from it and deleted. The listener can
|
1082
|
-
// also be NULL in which case it will not be added to the list. Does
|
1083
|
-
// nothing if the previous and the current listener objects are the same.
|
1084
|
-
void SetDefaultResultPrinter(TestEventListener* listener);
|
1085
|
-
|
1086
|
-
// Sets the default_xml_generator attribute to the provided listener. The
|
1087
|
-
// listener is also added to the listener list and previous
|
1088
|
-
// default_xml_generator is removed from it and deleted. The listener can
|
1089
|
-
// also be NULL in which case it will not be added to the list. Does
|
1090
|
-
// nothing if the previous and the current listener objects are the same.
|
1091
|
-
void SetDefaultXmlGenerator(TestEventListener* listener);
|
1092
|
-
|
1093
|
-
// Controls whether events will be forwarded by the repeater to the
|
1094
|
-
// listeners in the list.
|
1095
|
-
bool EventForwardingEnabled() const;
|
1096
|
-
void SuppressEventForwarding();
|
1097
|
-
|
1098
|
-
// The actual list of listeners.
|
1099
|
-
internal::TestEventRepeater* repeater_;
|
1100
|
-
// Listener responsible for the standard result output.
|
1101
|
-
TestEventListener* default_result_printer_;
|
1102
|
-
// Listener responsible for the creation of the XML output file.
|
1103
|
-
TestEventListener* default_xml_generator_;
|
1104
|
-
|
1105
|
-
// We disallow copying TestEventListeners.
|
1106
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(TestEventListeners);
|
1107
|
-
};
|
1108
|
-
|
1109
|
-
// A UnitTest consists of a vector of TestCases.
|
1110
|
-
//
|
1111
|
-
// This is a singleton class. The only instance of UnitTest is
|
1112
|
-
// created when UnitTest::GetInstance() is first called. This
|
1113
|
-
// instance is never deleted.
|
1114
|
-
//
|
1115
|
-
// UnitTest is not copyable.
|
1116
|
-
//
|
1117
|
-
// This class is thread-safe as long as the methods are called
|
1118
|
-
// according to their specification.
|
1119
|
-
class GTEST_API_ UnitTest {
|
1120
|
-
public:
|
1121
|
-
// Gets the singleton UnitTest object. The first time this method
|
1122
|
-
// is called, a UnitTest object is constructed and returned.
|
1123
|
-
// Consecutive calls will return the same object.
|
1124
|
-
static UnitTest* GetInstance();
|
1125
|
-
|
1126
|
-
// Runs all tests in this UnitTest object and prints the result.
|
1127
|
-
// Returns 0 if successful, or 1 otherwise.
|
1128
|
-
//
|
1129
|
-
// This method can only be called from the main thread.
|
1130
|
-
//
|
1131
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1132
|
-
int Run() GTEST_MUST_USE_RESULT_;
|
1133
|
-
|
1134
|
-
// Returns the working directory when the first TEST() or TEST_F()
|
1135
|
-
// was executed. The UnitTest object owns the string.
|
1136
|
-
const char* original_working_dir() const;
|
1137
|
-
|
1138
|
-
// Returns the TestCase object for the test that's currently running,
|
1139
|
-
// or NULL if no test is running.
|
1140
|
-
const TestCase* current_test_case() const
|
1141
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1142
|
-
|
1143
|
-
// Returns the TestInfo object for the test that's currently running,
|
1144
|
-
// or NULL if no test is running.
|
1145
|
-
const TestInfo* current_test_info() const
|
1146
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1147
|
-
|
1148
|
-
// Returns the random seed used at the start of the current test run.
|
1149
|
-
int random_seed() const;
|
1150
|
-
|
1151
|
-
#if GTEST_HAS_PARAM_TEST
|
1152
|
-
// Returns the ParameterizedTestCaseRegistry object used to keep track of
|
1153
|
-
// value-parameterized tests and instantiate and register them.
|
1154
|
-
//
|
1155
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1156
|
-
internal::ParameterizedTestCaseRegistry& parameterized_test_registry()
|
1157
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1158
|
-
#endif // GTEST_HAS_PARAM_TEST
|
1159
|
-
|
1160
|
-
// Gets the number of successful test cases.
|
1161
|
-
int successful_test_case_count() const;
|
1162
|
-
|
1163
|
-
// Gets the number of failed test cases.
|
1164
|
-
int failed_test_case_count() const;
|
1165
|
-
|
1166
|
-
// Gets the number of all test cases.
|
1167
|
-
int total_test_case_count() const;
|
1168
|
-
|
1169
|
-
// Gets the number of all test cases that contain at least one test
|
1170
|
-
// that should run.
|
1171
|
-
int test_case_to_run_count() const;
|
1172
|
-
|
1173
|
-
// Gets the number of successful tests.
|
1174
|
-
int successful_test_count() const;
|
1175
|
-
|
1176
|
-
// Gets the number of failed tests.
|
1177
|
-
int failed_test_count() const;
|
1178
|
-
|
1179
|
-
// Gets the number of disabled tests that will be reported in the XML report.
|
1180
|
-
int reportable_disabled_test_count() const;
|
1181
|
-
|
1182
|
-
// Gets the number of disabled tests.
|
1183
|
-
int disabled_test_count() const;
|
1184
|
-
|
1185
|
-
// Gets the number of tests to be printed in the XML report.
|
1186
|
-
int reportable_test_count() const;
|
1187
|
-
|
1188
|
-
// Gets the number of all tests.
|
1189
|
-
int total_test_count() const;
|
1190
|
-
|
1191
|
-
// Gets the number of tests that should run.
|
1192
|
-
int test_to_run_count() const;
|
1193
|
-
|
1194
|
-
// Gets the time of the test program start, in ms from the start of the
|
1195
|
-
// UNIX epoch.
|
1196
|
-
TimeInMillis start_timestamp() const;
|
1197
|
-
|
1198
|
-
// Gets the elapsed time, in milliseconds.
|
1199
|
-
TimeInMillis elapsed_time() const;
|
1200
|
-
|
1201
|
-
// Returns true iff the unit test passed (i.e. all test cases passed).
|
1202
|
-
bool Passed() const;
|
1203
|
-
|
1204
|
-
// Returns true iff the unit test failed (i.e. some test case failed
|
1205
|
-
// or something outside of all tests failed).
|
1206
|
-
bool Failed() const;
|
1207
|
-
|
1208
|
-
// Gets the i-th test case among all the test cases. i can range from 0 to
|
1209
|
-
// total_test_case_count() - 1. If i is not in that range, returns NULL.
|
1210
|
-
const TestCase* GetTestCase(int i) const;
|
1211
|
-
|
1212
|
-
// Returns the TestResult containing information on test failures and
|
1213
|
-
// properties logged outside of individual test cases.
|
1214
|
-
const TestResult& ad_hoc_test_result() const;
|
1215
|
-
|
1216
|
-
// Returns the list of event listeners that can be used to track events
|
1217
|
-
// inside Google Test.
|
1218
|
-
TestEventListeners& listeners();
|
1219
|
-
|
1220
|
-
private:
|
1221
|
-
// Registers and returns a global test environment. When a test
|
1222
|
-
// program is run, all global test environments will be set-up in
|
1223
|
-
// the order they were registered. After all tests in the program
|
1224
|
-
// have finished, all global test environments will be torn-down in
|
1225
|
-
// the *reverse* order they were registered.
|
1226
|
-
//
|
1227
|
-
// The UnitTest object takes ownership of the given environment.
|
1228
|
-
//
|
1229
|
-
// This method can only be called from the main thread.
|
1230
|
-
Environment* AddEnvironment(Environment* env);
|
1231
|
-
|
1232
|
-
// Adds a TestPartResult to the current TestResult object. All
|
1233
|
-
// Google Test assertion macros (e.g. ASSERT_TRUE, EXPECT_EQ, etc)
|
1234
|
-
// eventually call this to report their results. The user code
|
1235
|
-
// should use the assertion macros instead of calling this directly.
|
1236
|
-
void AddTestPartResult(TestPartResult::Type result_type,
|
1237
|
-
const char* file_name,
|
1238
|
-
int line_number,
|
1239
|
-
const std::string& message,
|
1240
|
-
const std::string& os_stack_trace)
|
1241
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1242
|
-
|
1243
|
-
// Adds a TestProperty to the current TestResult object when invoked from
|
1244
|
-
// inside a test, to current TestCase's ad_hoc_test_result_ when invoked
|
1245
|
-
// from SetUpTestCase or TearDownTestCase, or to the global property set
|
1246
|
-
// when invoked elsewhere. If the result already contains a property with
|
1247
|
-
// the same key, the value will be updated.
|
1248
|
-
void RecordProperty(const std::string& key, const std::string& value);
|
1249
|
-
|
1250
|
-
// Gets the i-th test case among all the test cases. i can range from 0 to
|
1251
|
-
// total_test_case_count() - 1. If i is not in that range, returns NULL.
|
1252
|
-
TestCase* GetMutableTestCase(int i);
|
1253
|
-
|
1254
|
-
// Accessors for the implementation object.
|
1255
|
-
internal::UnitTestImpl* impl() { return impl_; }
|
1256
|
-
const internal::UnitTestImpl* impl() const { return impl_; }
|
1257
|
-
|
1258
|
-
// These classes and funcions are friends as they need to access private
|
1259
|
-
// members of UnitTest.
|
1260
|
-
friend class Test;
|
1261
|
-
friend class internal::AssertHelper;
|
1262
|
-
friend class internal::ScopedTrace;
|
1263
|
-
friend class internal::StreamingListenerTest;
|
1264
|
-
friend class internal::UnitTestRecordPropertyTestHelper;
|
1265
|
-
friend Environment* AddGlobalTestEnvironment(Environment* env);
|
1266
|
-
friend internal::UnitTestImpl* internal::GetUnitTestImpl();
|
1267
|
-
friend void internal::ReportFailureInUnknownLocation(
|
1268
|
-
TestPartResult::Type result_type,
|
1269
|
-
const std::string& message);
|
1270
|
-
|
1271
|
-
// Creates an empty UnitTest.
|
1272
|
-
UnitTest();
|
1273
|
-
|
1274
|
-
// D'tor
|
1275
|
-
virtual ~UnitTest();
|
1276
|
-
|
1277
|
-
// Pushes a trace defined by SCOPED_TRACE() on to the per-thread
|
1278
|
-
// Google Test trace stack.
|
1279
|
-
void PushGTestTrace(const internal::TraceInfo& trace)
|
1280
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1281
|
-
|
1282
|
-
// Pops a trace from the per-thread Google Test trace stack.
|
1283
|
-
void PopGTestTrace()
|
1284
|
-
GTEST_LOCK_EXCLUDED_(mutex_);
|
1285
|
-
|
1286
|
-
// Protects mutable state in *impl_. This is mutable as some const
|
1287
|
-
// methods need to lock it too.
|
1288
|
-
mutable internal::Mutex mutex_;
|
1289
|
-
|
1290
|
-
// Opaque implementation object. This field is never changed once
|
1291
|
-
// the object is constructed. We don't mark it as const here, as
|
1292
|
-
// doing so will cause a warning in the constructor of UnitTest.
|
1293
|
-
// Mutable state in *impl_ is protected by mutex_.
|
1294
|
-
internal::UnitTestImpl* impl_;
|
1295
|
-
|
1296
|
-
// We disallow copying UnitTest.
|
1297
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(UnitTest);
|
1298
|
-
};
|
1299
|
-
|
1300
|
-
// A convenient wrapper for adding an environment for the test
|
1301
|
-
// program.
|
1302
|
-
//
|
1303
|
-
// You should call this before RUN_ALL_TESTS() is called, probably in
|
1304
|
-
// main(). If you use gtest_main, you need to call this before main()
|
1305
|
-
// starts for it to take effect. For example, you can define a global
|
1306
|
-
// variable like this:
|
1307
|
-
//
|
1308
|
-
// testing::Environment* const foo_env =
|
1309
|
-
// testing::AddGlobalTestEnvironment(new FooEnvironment);
|
1310
|
-
//
|
1311
|
-
// However, we strongly recommend you to write your own main() and
|
1312
|
-
// call AddGlobalTestEnvironment() there, as relying on initialization
|
1313
|
-
// of global variables makes the code harder to read and may cause
|
1314
|
-
// problems when you register multiple environments from different
|
1315
|
-
// translation units and the environments have dependencies among them
|
1316
|
-
// (remember that the compiler doesn't guarantee the order in which
|
1317
|
-
// global variables from different translation units are initialized).
|
1318
|
-
inline Environment* AddGlobalTestEnvironment(Environment* env) {
|
1319
|
-
return UnitTest::GetInstance()->AddEnvironment(env);
|
1320
|
-
}
|
1321
|
-
|
1322
|
-
// Initializes Google Test. This must be called before calling
|
1323
|
-
// RUN_ALL_TESTS(). In particular, it parses a command line for the
|
1324
|
-
// flags that Google Test recognizes. Whenever a Google Test flag is
|
1325
|
-
// seen, it is removed from argv, and *argc is decremented.
|
1326
|
-
//
|
1327
|
-
// No value is returned. Instead, the Google Test flag variables are
|
1328
|
-
// updated.
|
1329
|
-
//
|
1330
|
-
// Calling the function for the second time has no user-visible effect.
|
1331
|
-
GTEST_API_ void InitGoogleTest(int* argc, char** argv);
|
1332
|
-
|
1333
|
-
// This overloaded version can be used in Windows programs compiled in
|
1334
|
-
// UNICODE mode.
|
1335
|
-
GTEST_API_ void InitGoogleTest(int* argc, wchar_t** argv);
|
1336
|
-
|
1337
|
-
namespace internal {
|
1338
|
-
|
1339
|
-
// FormatForComparison<ToPrint, OtherOperand>::Format(value) formats a
|
1340
|
-
// value of type ToPrint that is an operand of a comparison assertion
|
1341
|
-
// (e.g. ASSERT_EQ). OtherOperand is the type of the other operand in
|
1342
|
-
// the comparison, and is used to help determine the best way to
|
1343
|
-
// format the value. In particular, when the value is a C string
|
1344
|
-
// (char pointer) and the other operand is an STL string object, we
|
1345
|
-
// want to format the C string as a string, since we know it is
|
1346
|
-
// compared by value with the string object. If the value is a char
|
1347
|
-
// pointer but the other operand is not an STL string object, we don't
|
1348
|
-
// know whether the pointer is supposed to point to a NUL-terminated
|
1349
|
-
// string, and thus want to print it as a pointer to be safe.
|
1350
|
-
//
|
1351
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1352
|
-
|
1353
|
-
// The default case.
|
1354
|
-
template <typename ToPrint, typename OtherOperand>
|
1355
|
-
class FormatForComparison {
|
1356
|
-
public:
|
1357
|
-
static ::std::string Format(const ToPrint& value) {
|
1358
|
-
return ::testing::PrintToString(value);
|
1359
|
-
}
|
1360
|
-
};
|
1361
|
-
|
1362
|
-
// Array.
|
1363
|
-
template <typename ToPrint, size_t N, typename OtherOperand>
|
1364
|
-
class FormatForComparison<ToPrint[N], OtherOperand> {
|
1365
|
-
public:
|
1366
|
-
static ::std::string Format(const ToPrint* value) {
|
1367
|
-
return FormatForComparison<const ToPrint*, OtherOperand>::Format(value);
|
1368
|
-
}
|
1369
|
-
};
|
1370
|
-
|
1371
|
-
// By default, print C string as pointers to be safe, as we don't know
|
1372
|
-
// whether they actually point to a NUL-terminated string.
|
1373
|
-
|
1374
|
-
#define GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_(CharType) \
|
1375
|
-
template <typename OtherOperand> \
|
1376
|
-
class FormatForComparison<CharType*, OtherOperand> { \
|
1377
|
-
public: \
|
1378
|
-
static ::std::string Format(CharType* value) { \
|
1379
|
-
return ::testing::PrintToString(static_cast<const void*>(value)); \
|
1380
|
-
} \
|
1381
|
-
}
|
1382
|
-
|
1383
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_(char);
|
1384
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_(const char);
|
1385
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_(wchar_t);
|
1386
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_(const wchar_t);
|
1387
|
-
|
1388
|
-
#undef GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_
|
1389
|
-
|
1390
|
-
// If a C string is compared with an STL string object, we know it's meant
|
1391
|
-
// to point to a NUL-terminated string, and thus can print it as a string.
|
1392
|
-
|
1393
|
-
#define GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(CharType, OtherStringType) \
|
1394
|
-
template <> \
|
1395
|
-
class FormatForComparison<CharType*, OtherStringType> { \
|
1396
|
-
public: \
|
1397
|
-
static ::std::string Format(CharType* value) { \
|
1398
|
-
return ::testing::PrintToString(value); \
|
1399
|
-
} \
|
1400
|
-
}
|
1401
|
-
|
1402
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(char, ::std::string);
|
1403
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(const char, ::std::string);
|
1404
|
-
|
1405
|
-
#if GTEST_HAS_GLOBAL_STRING
|
1406
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(char, ::string);
|
1407
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(const char, ::string);
|
1408
|
-
#endif
|
1409
|
-
|
1410
|
-
#if GTEST_HAS_GLOBAL_WSTRING
|
1411
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(wchar_t, ::wstring);
|
1412
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(const wchar_t, ::wstring);
|
1413
|
-
#endif
|
1414
|
-
|
1415
|
-
#if GTEST_HAS_STD_WSTRING
|
1416
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(wchar_t, ::std::wstring);
|
1417
|
-
GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(const wchar_t, ::std::wstring);
|
1418
|
-
#endif
|
1419
|
-
|
1420
|
-
#undef GTEST_IMPL_FORMAT_C_STRING_AS_STRING_
|
1421
|
-
|
1422
|
-
// Formats a comparison assertion (e.g. ASSERT_EQ, EXPECT_LT, and etc)
|
1423
|
-
// operand to be used in a failure message. The type (but not value)
|
1424
|
-
// of the other operand may affect the format. This allows us to
|
1425
|
-
// print a char* as a raw pointer when it is compared against another
|
1426
|
-
// char* or void*, and print it as a C string when it is compared
|
1427
|
-
// against an std::string object, for example.
|
1428
|
-
//
|
1429
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1430
|
-
template <typename T1, typename T2>
|
1431
|
-
std::string FormatForComparisonFailureMessage(
|
1432
|
-
const T1& value, const T2& /* other_operand */) {
|
1433
|
-
return FormatForComparison<T1, T2>::Format(value);
|
1434
|
-
}
|
1435
|
-
|
1436
|
-
// The helper function for {ASSERT|EXPECT}_EQ.
|
1437
|
-
template <typename T1, typename T2>
|
1438
|
-
AssertionResult CmpHelperEQ(const char* expected_expression,
|
1439
|
-
const char* actual_expression,
|
1440
|
-
const T1& expected,
|
1441
|
-
const T2& actual) {
|
1442
|
-
#ifdef _MSC_VER
|
1443
|
-
# pragma warning(push) // Saves the current warning state.
|
1444
|
-
# pragma warning(disable:4389) // Temporarily disables warning on
|
1445
|
-
// signed/unsigned mismatch.
|
1446
|
-
#endif
|
1447
|
-
|
1448
|
-
if (expected == actual) {
|
1449
|
-
return AssertionSuccess();
|
1450
|
-
}
|
1451
|
-
|
1452
|
-
#ifdef _MSC_VER
|
1453
|
-
# pragma warning(pop) // Restores the warning state.
|
1454
|
-
#endif
|
1455
|
-
|
1456
|
-
return EqFailure(expected_expression,
|
1457
|
-
actual_expression,
|
1458
|
-
FormatForComparisonFailureMessage(expected, actual),
|
1459
|
-
FormatForComparisonFailureMessage(actual, expected),
|
1460
|
-
false);
|
1461
|
-
}
|
1462
|
-
|
1463
|
-
// With this overloaded version, we allow anonymous enums to be used
|
1464
|
-
// in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous enums
|
1465
|
-
// can be implicitly cast to BiggestInt.
|
1466
|
-
GTEST_API_ AssertionResult CmpHelperEQ(const char* expected_expression,
|
1467
|
-
const char* actual_expression,
|
1468
|
-
BiggestInt expected,
|
1469
|
-
BiggestInt actual);
|
1470
|
-
|
1471
|
-
// The helper class for {ASSERT|EXPECT}_EQ. The template argument
|
1472
|
-
// lhs_is_null_literal is true iff the first argument to ASSERT_EQ()
|
1473
|
-
// is a null pointer literal. The following default implementation is
|
1474
|
-
// for lhs_is_null_literal being false.
|
1475
|
-
template <bool lhs_is_null_literal>
|
1476
|
-
class EqHelper {
|
1477
|
-
public:
|
1478
|
-
// This templatized version is for the general case.
|
1479
|
-
template <typename T1, typename T2>
|
1480
|
-
static AssertionResult Compare(const char* expected_expression,
|
1481
|
-
const char* actual_expression,
|
1482
|
-
const T1& expected,
|
1483
|
-
const T2& actual) {
|
1484
|
-
return CmpHelperEQ(expected_expression, actual_expression, expected,
|
1485
|
-
actual);
|
1486
|
-
}
|
1487
|
-
|
1488
|
-
// With this overloaded version, we allow anonymous enums to be used
|
1489
|
-
// in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous
|
1490
|
-
// enums can be implicitly cast to BiggestInt.
|
1491
|
-
//
|
1492
|
-
// Even though its body looks the same as the above version, we
|
1493
|
-
// cannot merge the two, as it will make anonymous enums unhappy.
|
1494
|
-
static AssertionResult Compare(const char* expected_expression,
|
1495
|
-
const char* actual_expression,
|
1496
|
-
BiggestInt expected,
|
1497
|
-
BiggestInt actual) {
|
1498
|
-
return CmpHelperEQ(expected_expression, actual_expression, expected,
|
1499
|
-
actual);
|
1500
|
-
}
|
1501
|
-
};
|
1502
|
-
|
1503
|
-
// This specialization is used when the first argument to ASSERT_EQ()
|
1504
|
-
// is a null pointer literal, like NULL, false, or 0.
|
1505
|
-
template <>
|
1506
|
-
class EqHelper<true> {
|
1507
|
-
public:
|
1508
|
-
// We define two overloaded versions of Compare(). The first
|
1509
|
-
// version will be picked when the second argument to ASSERT_EQ() is
|
1510
|
-
// NOT a pointer, e.g. ASSERT_EQ(0, AnIntFunction()) or
|
1511
|
-
// EXPECT_EQ(false, a_bool).
|
1512
|
-
template <typename T1, typename T2>
|
1513
|
-
static AssertionResult Compare(
|
1514
|
-
const char* expected_expression,
|
1515
|
-
const char* actual_expression,
|
1516
|
-
const T1& expected,
|
1517
|
-
const T2& actual,
|
1518
|
-
// The following line prevents this overload from being considered if T2
|
1519
|
-
// is not a pointer type. We need this because ASSERT_EQ(NULL, my_ptr)
|
1520
|
-
// expands to Compare("", "", NULL, my_ptr), which requires a conversion
|
1521
|
-
// to match the Secret* in the other overload, which would otherwise make
|
1522
|
-
// this template match better.
|
1523
|
-
typename EnableIf<!is_pointer<T2>::value>::type* = 0) {
|
1524
|
-
return CmpHelperEQ(expected_expression, actual_expression, expected,
|
1525
|
-
actual);
|
1526
|
-
}
|
1527
|
-
|
1528
|
-
// This version will be picked when the second argument to ASSERT_EQ() is a
|
1529
|
-
// pointer, e.g. ASSERT_EQ(NULL, a_pointer).
|
1530
|
-
template <typename T>
|
1531
|
-
static AssertionResult Compare(
|
1532
|
-
const char* expected_expression,
|
1533
|
-
const char* actual_expression,
|
1534
|
-
// We used to have a second template parameter instead of Secret*. That
|
1535
|
-
// template parameter would deduce to 'long', making this a better match
|
1536
|
-
// than the first overload even without the first overload's EnableIf.
|
1537
|
-
// Unfortunately, gcc with -Wconversion-null warns when "passing NULL to
|
1538
|
-
// non-pointer argument" (even a deduced integral argument), so the old
|
1539
|
-
// implementation caused warnings in user code.
|
1540
|
-
Secret* /* expected (NULL) */,
|
1541
|
-
T* actual) {
|
1542
|
-
// We already know that 'expected' is a null pointer.
|
1543
|
-
return CmpHelperEQ(expected_expression, actual_expression,
|
1544
|
-
static_cast<T*>(NULL), actual);
|
1545
|
-
}
|
1546
|
-
};
|
1547
|
-
|
1548
|
-
// A macro for implementing the helper functions needed to implement
|
1549
|
-
// ASSERT_?? and EXPECT_??. It is here just to avoid copy-and-paste
|
1550
|
-
// of similar code.
|
1551
|
-
//
|
1552
|
-
// For each templatized helper function, we also define an overloaded
|
1553
|
-
// version for BiggestInt in order to reduce code bloat and allow
|
1554
|
-
// anonymous enums to be used with {ASSERT|EXPECT}_?? when compiled
|
1555
|
-
// with gcc 4.
|
1556
|
-
//
|
1557
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1558
|
-
#define GTEST_IMPL_CMP_HELPER_(op_name, op)\
|
1559
|
-
template <typename T1, typename T2>\
|
1560
|
-
AssertionResult CmpHelper##op_name(const char* expr1, const char* expr2, \
|
1561
|
-
const T1& val1, const T2& val2) {\
|
1562
|
-
if (val1 op val2) {\
|
1563
|
-
return AssertionSuccess();\
|
1564
|
-
} else {\
|
1565
|
-
return AssertionFailure() \
|
1566
|
-
<< "Expected: (" << expr1 << ") " #op " (" << expr2\
|
1567
|
-
<< "), actual: " << FormatForComparisonFailureMessage(val1, val2)\
|
1568
|
-
<< " vs " << FormatForComparisonFailureMessage(val2, val1);\
|
1569
|
-
}\
|
1570
|
-
}\
|
1571
|
-
GTEST_API_ AssertionResult CmpHelper##op_name(\
|
1572
|
-
const char* expr1, const char* expr2, BiggestInt val1, BiggestInt val2)
|
1573
|
-
|
1574
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1575
|
-
|
1576
|
-
// Implements the helper function for {ASSERT|EXPECT}_NE
|
1577
|
-
GTEST_IMPL_CMP_HELPER_(NE, !=);
|
1578
|
-
// Implements the helper function for {ASSERT|EXPECT}_LE
|
1579
|
-
GTEST_IMPL_CMP_HELPER_(LE, <=);
|
1580
|
-
// Implements the helper function for {ASSERT|EXPECT}_LT
|
1581
|
-
GTEST_IMPL_CMP_HELPER_(LT, <);
|
1582
|
-
// Implements the helper function for {ASSERT|EXPECT}_GE
|
1583
|
-
GTEST_IMPL_CMP_HELPER_(GE, >=);
|
1584
|
-
// Implements the helper function for {ASSERT|EXPECT}_GT
|
1585
|
-
GTEST_IMPL_CMP_HELPER_(GT, >);
|
1586
|
-
|
1587
|
-
#undef GTEST_IMPL_CMP_HELPER_
|
1588
|
-
|
1589
|
-
// The helper function for {ASSERT|EXPECT}_STREQ.
|
1590
|
-
//
|
1591
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1592
|
-
GTEST_API_ AssertionResult CmpHelperSTREQ(const char* expected_expression,
|
1593
|
-
const char* actual_expression,
|
1594
|
-
const char* expected,
|
1595
|
-
const char* actual);
|
1596
|
-
|
1597
|
-
// The helper function for {ASSERT|EXPECT}_STRCASEEQ.
|
1598
|
-
//
|
1599
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1600
|
-
GTEST_API_ AssertionResult CmpHelperSTRCASEEQ(const char* expected_expression,
|
1601
|
-
const char* actual_expression,
|
1602
|
-
const char* expected,
|
1603
|
-
const char* actual);
|
1604
|
-
|
1605
|
-
// The helper function for {ASSERT|EXPECT}_STRNE.
|
1606
|
-
//
|
1607
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1608
|
-
GTEST_API_ AssertionResult CmpHelperSTRNE(const char* s1_expression,
|
1609
|
-
const char* s2_expression,
|
1610
|
-
const char* s1,
|
1611
|
-
const char* s2);
|
1612
|
-
|
1613
|
-
// The helper function for {ASSERT|EXPECT}_STRCASENE.
|
1614
|
-
//
|
1615
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1616
|
-
GTEST_API_ AssertionResult CmpHelperSTRCASENE(const char* s1_expression,
|
1617
|
-
const char* s2_expression,
|
1618
|
-
const char* s1,
|
1619
|
-
const char* s2);
|
1620
|
-
|
1621
|
-
|
1622
|
-
// Helper function for *_STREQ on wide strings.
|
1623
|
-
//
|
1624
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1625
|
-
GTEST_API_ AssertionResult CmpHelperSTREQ(const char* expected_expression,
|
1626
|
-
const char* actual_expression,
|
1627
|
-
const wchar_t* expected,
|
1628
|
-
const wchar_t* actual);
|
1629
|
-
|
1630
|
-
// Helper function for *_STRNE on wide strings.
|
1631
|
-
//
|
1632
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1633
|
-
GTEST_API_ AssertionResult CmpHelperSTRNE(const char* s1_expression,
|
1634
|
-
const char* s2_expression,
|
1635
|
-
const wchar_t* s1,
|
1636
|
-
const wchar_t* s2);
|
1637
|
-
|
1638
|
-
} // namespace internal
|
1639
|
-
|
1640
|
-
// IsSubstring() and IsNotSubstring() are intended to be used as the
|
1641
|
-
// first argument to {EXPECT,ASSERT}_PRED_FORMAT2(), not by
|
1642
|
-
// themselves. They check whether needle is a substring of haystack
|
1643
|
-
// (NULL is considered a substring of itself only), and return an
|
1644
|
-
// appropriate error message when they fail.
|
1645
|
-
//
|
1646
|
-
// The {needle,haystack}_expr arguments are the stringified
|
1647
|
-
// expressions that generated the two real arguments.
|
1648
|
-
GTEST_API_ AssertionResult IsSubstring(
|
1649
|
-
const char* needle_expr, const char* haystack_expr,
|
1650
|
-
const char* needle, const char* haystack);
|
1651
|
-
GTEST_API_ AssertionResult IsSubstring(
|
1652
|
-
const char* needle_expr, const char* haystack_expr,
|
1653
|
-
const wchar_t* needle, const wchar_t* haystack);
|
1654
|
-
GTEST_API_ AssertionResult IsNotSubstring(
|
1655
|
-
const char* needle_expr, const char* haystack_expr,
|
1656
|
-
const char* needle, const char* haystack);
|
1657
|
-
GTEST_API_ AssertionResult IsNotSubstring(
|
1658
|
-
const char* needle_expr, const char* haystack_expr,
|
1659
|
-
const wchar_t* needle, const wchar_t* haystack);
|
1660
|
-
GTEST_API_ AssertionResult IsSubstring(
|
1661
|
-
const char* needle_expr, const char* haystack_expr,
|
1662
|
-
const ::std::string& needle, const ::std::string& haystack);
|
1663
|
-
GTEST_API_ AssertionResult IsNotSubstring(
|
1664
|
-
const char* needle_expr, const char* haystack_expr,
|
1665
|
-
const ::std::string& needle, const ::std::string& haystack);
|
1666
|
-
|
1667
|
-
#if GTEST_HAS_STD_WSTRING
|
1668
|
-
GTEST_API_ AssertionResult IsSubstring(
|
1669
|
-
const char* needle_expr, const char* haystack_expr,
|
1670
|
-
const ::std::wstring& needle, const ::std::wstring& haystack);
|
1671
|
-
GTEST_API_ AssertionResult IsNotSubstring(
|
1672
|
-
const char* needle_expr, const char* haystack_expr,
|
1673
|
-
const ::std::wstring& needle, const ::std::wstring& haystack);
|
1674
|
-
#endif // GTEST_HAS_STD_WSTRING
|
1675
|
-
|
1676
|
-
namespace internal {
|
1677
|
-
|
1678
|
-
// Helper template function for comparing floating-points.
|
1679
|
-
//
|
1680
|
-
// Template parameter:
|
1681
|
-
//
|
1682
|
-
// RawType: the raw floating-point type (either float or double)
|
1683
|
-
//
|
1684
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1685
|
-
template <typename RawType>
|
1686
|
-
AssertionResult CmpHelperFloatingPointEQ(const char* expected_expression,
|
1687
|
-
const char* actual_expression,
|
1688
|
-
RawType expected,
|
1689
|
-
RawType actual) {
|
1690
|
-
const FloatingPoint<RawType> lhs(expected), rhs(actual);
|
1691
|
-
|
1692
|
-
if (lhs.AlmostEquals(rhs)) {
|
1693
|
-
return AssertionSuccess();
|
1694
|
-
}
|
1695
|
-
|
1696
|
-
::std::stringstream expected_ss;
|
1697
|
-
expected_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)
|
1698
|
-
<< expected;
|
1699
|
-
|
1700
|
-
::std::stringstream actual_ss;
|
1701
|
-
actual_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)
|
1702
|
-
<< actual;
|
1703
|
-
|
1704
|
-
return EqFailure(expected_expression,
|
1705
|
-
actual_expression,
|
1706
|
-
StringStreamToString(&expected_ss),
|
1707
|
-
StringStreamToString(&actual_ss),
|
1708
|
-
false);
|
1709
|
-
}
|
1710
|
-
|
1711
|
-
// Helper function for implementing ASSERT_NEAR.
|
1712
|
-
//
|
1713
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.
|
1714
|
-
GTEST_API_ AssertionResult DoubleNearPredFormat(const char* expr1,
|
1715
|
-
const char* expr2,
|
1716
|
-
const char* abs_error_expr,
|
1717
|
-
double val1,
|
1718
|
-
double val2,
|
1719
|
-
double abs_error);
|
1720
|
-
|
1721
|
-
// INTERNAL IMPLEMENTATION - DO NOT USE IN USER CODE.
|
1722
|
-
// A class that enables one to stream messages to assertion macros
|
1723
|
-
class GTEST_API_ AssertHelper {
|
1724
|
-
public:
|
1725
|
-
// Constructor.
|
1726
|
-
AssertHelper(TestPartResult::Type type,
|
1727
|
-
const char* file,
|
1728
|
-
int line,
|
1729
|
-
const char* message);
|
1730
|
-
~AssertHelper();
|
1731
|
-
|
1732
|
-
// Message assignment is a semantic trick to enable assertion
|
1733
|
-
// streaming; see the GTEST_MESSAGE_ macro below.
|
1734
|
-
void operator=(const Message& message) const;
|
1735
|
-
|
1736
|
-
private:
|
1737
|
-
// We put our data in a struct so that the size of the AssertHelper class can
|
1738
|
-
// be as small as possible. This is important because gcc is incapable of
|
1739
|
-
// re-using stack space even for temporary variables, so every EXPECT_EQ
|
1740
|
-
// reserves stack space for another AssertHelper.
|
1741
|
-
struct AssertHelperData {
|
1742
|
-
AssertHelperData(TestPartResult::Type t,
|
1743
|
-
const char* srcfile,
|
1744
|
-
int line_num,
|
1745
|
-
const char* msg)
|
1746
|
-
: type(t), file(srcfile), line(line_num), message(msg) { }
|
1747
|
-
|
1748
|
-
TestPartResult::Type const type;
|
1749
|
-
const char* const file;
|
1750
|
-
int const line;
|
1751
|
-
std::string const message;
|
1752
|
-
|
1753
|
-
private:
|
1754
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(AssertHelperData);
|
1755
|
-
};
|
1756
|
-
|
1757
|
-
AssertHelperData* const data_;
|
1758
|
-
|
1759
|
-
GTEST_DISALLOW_COPY_AND_ASSIGN_(AssertHelper);
|
1760
|
-
};
|
1761
|
-
|
1762
|
-
} // namespace internal
|
1763
|
-
|
1764
|
-
#if GTEST_HAS_PARAM_TEST
|
1765
|
-
// The pure interface class that all value-parameterized tests inherit from.
|
1766
|
-
// A value-parameterized class must inherit from both ::testing::Test and
|
1767
|
-
// ::testing::WithParamInterface. In most cases that just means inheriting
|
1768
|
-
// from ::testing::TestWithParam, but more complicated test hierarchies
|
1769
|
-
// may need to inherit from Test and WithParamInterface at different levels.
|
1770
|
-
//
|
1771
|
-
// This interface has support for accessing the test parameter value via
|
1772
|
-
// the GetParam() method.
|
1773
|
-
//
|
1774
|
-
// Use it with one of the parameter generator defining functions, like Range(),
|
1775
|
-
// Values(), ValuesIn(), Bool(), and Combine().
|
1776
|
-
//
|
1777
|
-
// class FooTest : public ::testing::TestWithParam<int> {
|
1778
|
-
// protected:
|
1779
|
-
// FooTest() {
|
1780
|
-
// // Can use GetParam() here.
|
1781
|
-
// }
|
1782
|
-
// virtual ~FooTest() {
|
1783
|
-
// // Can use GetParam() here.
|
1784
|
-
// }
|
1785
|
-
// virtual void SetUp() {
|
1786
|
-
// // Can use GetParam() here.
|
1787
|
-
// }
|
1788
|
-
// virtual void TearDown {
|
1789
|
-
// // Can use GetParam() here.
|
1790
|
-
// }
|
1791
|
-
// };
|
1792
|
-
// TEST_P(FooTest, DoesBar) {
|
1793
|
-
// // Can use GetParam() method here.
|
1794
|
-
// Foo foo;
|
1795
|
-
// ASSERT_TRUE(foo.DoesBar(GetParam()));
|
1796
|
-
// }
|
1797
|
-
// INSTANTIATE_TEST_CASE_P(OneToTenRange, FooTest, ::testing::Range(1, 10));
|
1798
|
-
|
1799
|
-
template <typename T>
|
1800
|
-
class WithParamInterface {
|
1801
|
-
public:
|
1802
|
-
typedef T ParamType;
|
1803
|
-
virtual ~WithParamInterface() {}
|
1804
|
-
|
1805
|
-
// The current parameter value. Is also available in the test fixture's
|
1806
|
-
// constructor. This member function is non-static, even though it only
|
1807
|
-
// references static data, to reduce the opportunity for incorrect uses
|
1808
|
-
// like writing 'WithParamInterface<bool>::GetParam()' for a test that
|
1809
|
-
// uses a fixture whose parameter type is int.
|
1810
|
-
const ParamType& GetParam() const {
|
1811
|
-
GTEST_CHECK_(parameter_ != NULL)
|
1812
|
-
<< "GetParam() can only be called inside a value-parameterized test "
|
1813
|
-
<< "-- did you intend to write TEST_P instead of TEST_F?";
|
1814
|
-
return *parameter_;
|
1815
|
-
}
|
1816
|
-
|
1817
|
-
private:
|
1818
|
-
// Sets parameter value. The caller is responsible for making sure the value
|
1819
|
-
// remains alive and unchanged throughout the current test.
|
1820
|
-
static void SetParam(const ParamType* parameter) {
|
1821
|
-
parameter_ = parameter;
|
1822
|
-
}
|
1823
|
-
|
1824
|
-
// Static value used for accessing parameter during a test lifetime.
|
1825
|
-
static const ParamType* parameter_;
|
1826
|
-
|
1827
|
-
// TestClass must be a subclass of WithParamInterface<T> and Test.
|
1828
|
-
template <class TestClass> friend class internal::ParameterizedTestFactory;
|
1829
|
-
};
|
1830
|
-
|
1831
|
-
template <typename T>
|
1832
|
-
const T* WithParamInterface<T>::parameter_ = NULL;
|
1833
|
-
|
1834
|
-
// Most value-parameterized classes can ignore the existence of
|
1835
|
-
// WithParamInterface, and can just inherit from ::testing::TestWithParam.
|
1836
|
-
|
1837
|
-
template <typename T>
|
1838
|
-
class TestWithParam : public Test, public WithParamInterface<T> {
|
1839
|
-
};
|
1840
|
-
|
1841
|
-
#endif // GTEST_HAS_PARAM_TEST
|
1842
|
-
|
1843
|
-
// Macros for indicating success/failure in test code.
|
1844
|
-
|
1845
|
-
// ADD_FAILURE unconditionally adds a failure to the current test.
|
1846
|
-
// SUCCEED generates a success - it doesn't automatically make the
|
1847
|
-
// current test successful, as a test is only successful when it has
|
1848
|
-
// no failure.
|
1849
|
-
//
|
1850
|
-
// EXPECT_* verifies that a certain condition is satisfied. If not,
|
1851
|
-
// it behaves like ADD_FAILURE. In particular:
|
1852
|
-
//
|
1853
|
-
// EXPECT_TRUE verifies that a Boolean condition is true.
|
1854
|
-
// EXPECT_FALSE verifies that a Boolean condition is false.
|
1855
|
-
//
|
1856
|
-
// FAIL and ASSERT_* are similar to ADD_FAILURE and EXPECT_*, except
|
1857
|
-
// that they will also abort the current function on failure. People
|
1858
|
-
// usually want the fail-fast behavior of FAIL and ASSERT_*, but those
|
1859
|
-
// writing data-driven tests often find themselves using ADD_FAILURE
|
1860
|
-
// and EXPECT_* more.
|
1861
|
-
|
1862
|
-
// Generates a nonfatal failure with a generic message.
|
1863
|
-
#define ADD_FAILURE() GTEST_NONFATAL_FAILURE_("Failed")
|
1864
|
-
|
1865
|
-
// Generates a nonfatal failure at the given source file location with
|
1866
|
-
// a generic message.
|
1867
|
-
#define ADD_FAILURE_AT(file, line) \
|
1868
|
-
GTEST_MESSAGE_AT_(file, line, "Failed", \
|
1869
|
-
::testing::TestPartResult::kNonFatalFailure)
|
1870
|
-
|
1871
|
-
// Generates a fatal failure with a generic message.
|
1872
|
-
#define GTEST_FAIL() GTEST_FATAL_FAILURE_("Failed")
|
1873
|
-
|
1874
|
-
// Define this macro to 1 to omit the definition of FAIL(), which is a
|
1875
|
-
// generic name and clashes with some other libraries.
|
1876
|
-
#if !GTEST_DONT_DEFINE_FAIL
|
1877
|
-
# define FAIL() GTEST_FAIL()
|
1878
|
-
#endif
|
1879
|
-
|
1880
|
-
// Generates a success with a generic message.
|
1881
|
-
#define GTEST_SUCCEED() GTEST_SUCCESS_("Succeeded")
|
1882
|
-
|
1883
|
-
// Define this macro to 1 to omit the definition of SUCCEED(), which
|
1884
|
-
// is a generic name and clashes with some other libraries.
|
1885
|
-
#if !GTEST_DONT_DEFINE_SUCCEED
|
1886
|
-
# define SUCCEED() GTEST_SUCCEED()
|
1887
|
-
#endif
|
1888
|
-
|
1889
|
-
// Macros for testing exceptions.
|
1890
|
-
//
|
1891
|
-
// * {ASSERT|EXPECT}_THROW(statement, expected_exception):
|
1892
|
-
// Tests that the statement throws the expected exception.
|
1893
|
-
// * {ASSERT|EXPECT}_NO_THROW(statement):
|
1894
|
-
// Tests that the statement doesn't throw any exception.
|
1895
|
-
// * {ASSERT|EXPECT}_ANY_THROW(statement):
|
1896
|
-
// Tests that the statement throws an exception.
|
1897
|
-
|
1898
|
-
#define EXPECT_THROW(statement, expected_exception) \
|
1899
|
-
GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)
|
1900
|
-
#define EXPECT_NO_THROW(statement) \
|
1901
|
-
GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)
|
1902
|
-
#define EXPECT_ANY_THROW(statement) \
|
1903
|
-
GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)
|
1904
|
-
#define ASSERT_THROW(statement, expected_exception) \
|
1905
|
-
GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)
|
1906
|
-
#define ASSERT_NO_THROW(statement) \
|
1907
|
-
GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)
|
1908
|
-
#define ASSERT_ANY_THROW(statement) \
|
1909
|
-
GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)
|
1910
|
-
|
1911
|
-
// Boolean assertions. Condition can be either a Boolean expression or an
|
1912
|
-
// AssertionResult. For more information on how to use AssertionResult with
|
1913
|
-
// these macros see comments on that class.
|
1914
|
-
#define EXPECT_TRUE(condition) \
|
1915
|
-
GTEST_TEST_BOOLEAN_(condition, #condition, false, true, \
|
1916
|
-
GTEST_NONFATAL_FAILURE_)
|
1917
|
-
#define EXPECT_FALSE(condition) \
|
1918
|
-
GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \
|
1919
|
-
GTEST_NONFATAL_FAILURE_)
|
1920
|
-
#define ASSERT_TRUE(condition) \
|
1921
|
-
GTEST_TEST_BOOLEAN_(condition, #condition, false, true, \
|
1922
|
-
GTEST_FATAL_FAILURE_)
|
1923
|
-
#define ASSERT_FALSE(condition) \
|
1924
|
-
GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \
|
1925
|
-
GTEST_FATAL_FAILURE_)
|
1926
|
-
|
1927
|
-
// Includes the auto-generated header that implements a family of
|
1928
|
-
// generic predicate assertion macros.
|
1929
|
-
#include "gtest/gtest_pred_impl.h"
|
1930
|
-
|
1931
|
-
// Macros for testing equalities and inequalities.
|
1932
|
-
//
|
1933
|
-
// * {ASSERT|EXPECT}_EQ(expected, actual): Tests that expected == actual
|
1934
|
-
// * {ASSERT|EXPECT}_NE(v1, v2): Tests that v1 != v2
|
1935
|
-
// * {ASSERT|EXPECT}_LT(v1, v2): Tests that v1 < v2
|
1936
|
-
// * {ASSERT|EXPECT}_LE(v1, v2): Tests that v1 <= v2
|
1937
|
-
// * {ASSERT|EXPECT}_GT(v1, v2): Tests that v1 > v2
|
1938
|
-
// * {ASSERT|EXPECT}_GE(v1, v2): Tests that v1 >= v2
|
1939
|
-
//
|
1940
|
-
// When they are not, Google Test prints both the tested expressions and
|
1941
|
-
// their actual values. The values must be compatible built-in types,
|
1942
|
-
// or you will get a compiler error. By "compatible" we mean that the
|
1943
|
-
// values can be compared by the respective operator.
|
1944
|
-
//
|
1945
|
-
// Note:
|
1946
|
-
//
|
1947
|
-
// 1. It is possible to make a user-defined type work with
|
1948
|
-
// {ASSERT|EXPECT}_??(), but that requires overloading the
|
1949
|
-
// comparison operators and is thus discouraged by the Google C++
|
1950
|
-
// Usage Guide. Therefore, you are advised to use the
|
1951
|
-
// {ASSERT|EXPECT}_TRUE() macro to assert that two objects are
|
1952
|
-
// equal.
|
1953
|
-
//
|
1954
|
-
// 2. The {ASSERT|EXPECT}_??() macros do pointer comparisons on
|
1955
|
-
// pointers (in particular, C strings). Therefore, if you use it
|
1956
|
-
// with two C strings, you are testing how their locations in memory
|
1957
|
-
// are related, not how their content is related. To compare two C
|
1958
|
-
// strings by content, use {ASSERT|EXPECT}_STR*().
|
1959
|
-
//
|
1960
|
-
// 3. {ASSERT|EXPECT}_EQ(expected, actual) is preferred to
|
1961
|
-
// {ASSERT|EXPECT}_TRUE(expected == actual), as the former tells you
|
1962
|
-
// what the actual value is when it fails, and similarly for the
|
1963
|
-
// other comparisons.
|
1964
|
-
//
|
1965
|
-
// 4. Do not depend on the order in which {ASSERT|EXPECT}_??()
|
1966
|
-
// evaluate their arguments, which is undefined.
|
1967
|
-
//
|
1968
|
-
// 5. These macros evaluate their arguments exactly once.
|
1969
|
-
//
|
1970
|
-
// Examples:
|
1971
|
-
//
|
1972
|
-
// EXPECT_NE(5, Foo());
|
1973
|
-
// EXPECT_EQ(NULL, a_pointer);
|
1974
|
-
// ASSERT_LT(i, array_size);
|
1975
|
-
// ASSERT_GT(records.size(), 0) << "There is no record left.";
|
1976
|
-
|
1977
|
-
#define EXPECT_EQ(expected, actual) \
|
1978
|
-
EXPECT_PRED_FORMAT2(::testing::internal:: \
|
1979
|
-
EqHelper<GTEST_IS_NULL_LITERAL_(expected)>::Compare, \
|
1980
|
-
expected, actual)
|
1981
|
-
#define EXPECT_NE(expected, actual) \
|
1982
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, expected, actual)
|
1983
|
-
#define EXPECT_LE(val1, val2) \
|
1984
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)
|
1985
|
-
#define EXPECT_LT(val1, val2) \
|
1986
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)
|
1987
|
-
#define EXPECT_GE(val1, val2) \
|
1988
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)
|
1989
|
-
#define EXPECT_GT(val1, val2) \
|
1990
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)
|
1991
|
-
|
1992
|
-
#define GTEST_ASSERT_EQ(expected, actual) \
|
1993
|
-
ASSERT_PRED_FORMAT2(::testing::internal:: \
|
1994
|
-
EqHelper<GTEST_IS_NULL_LITERAL_(expected)>::Compare, \
|
1995
|
-
expected, actual)
|
1996
|
-
#define GTEST_ASSERT_NE(val1, val2) \
|
1997
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)
|
1998
|
-
#define GTEST_ASSERT_LE(val1, val2) \
|
1999
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)
|
2000
|
-
#define GTEST_ASSERT_LT(val1, val2) \
|
2001
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)
|
2002
|
-
#define GTEST_ASSERT_GE(val1, val2) \
|
2003
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)
|
2004
|
-
#define GTEST_ASSERT_GT(val1, val2) \
|
2005
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)
|
2006
|
-
|
2007
|
-
// Define macro GTEST_DONT_DEFINE_ASSERT_XY to 1 to omit the definition of
|
2008
|
-
// ASSERT_XY(), which clashes with some users' own code.
|
2009
|
-
|
2010
|
-
#if !GTEST_DONT_DEFINE_ASSERT_EQ
|
2011
|
-
# define ASSERT_EQ(val1, val2) GTEST_ASSERT_EQ(val1, val2)
|
2012
|
-
#endif
|
2013
|
-
|
2014
|
-
#if !GTEST_DONT_DEFINE_ASSERT_NE
|
2015
|
-
# define ASSERT_NE(val1, val2) GTEST_ASSERT_NE(val1, val2)
|
2016
|
-
#endif
|
2017
|
-
|
2018
|
-
#if !GTEST_DONT_DEFINE_ASSERT_LE
|
2019
|
-
# define ASSERT_LE(val1, val2) GTEST_ASSERT_LE(val1, val2)
|
2020
|
-
#endif
|
2021
|
-
|
2022
|
-
#if !GTEST_DONT_DEFINE_ASSERT_LT
|
2023
|
-
# define ASSERT_LT(val1, val2) GTEST_ASSERT_LT(val1, val2)
|
2024
|
-
#endif
|
2025
|
-
|
2026
|
-
#if !GTEST_DONT_DEFINE_ASSERT_GE
|
2027
|
-
# define ASSERT_GE(val1, val2) GTEST_ASSERT_GE(val1, val2)
|
2028
|
-
#endif
|
2029
|
-
|
2030
|
-
#if !GTEST_DONT_DEFINE_ASSERT_GT
|
2031
|
-
# define ASSERT_GT(val1, val2) GTEST_ASSERT_GT(val1, val2)
|
2032
|
-
#endif
|
2033
|
-
|
2034
|
-
// C-string Comparisons. All tests treat NULL and any non-NULL string
|
2035
|
-
// as different. Two NULLs are equal.
|
2036
|
-
//
|
2037
|
-
// * {ASSERT|EXPECT}_STREQ(s1, s2): Tests that s1 == s2
|
2038
|
-
// * {ASSERT|EXPECT}_STRNE(s1, s2): Tests that s1 != s2
|
2039
|
-
// * {ASSERT|EXPECT}_STRCASEEQ(s1, s2): Tests that s1 == s2, ignoring case
|
2040
|
-
// * {ASSERT|EXPECT}_STRCASENE(s1, s2): Tests that s1 != s2, ignoring case
|
2041
|
-
//
|
2042
|
-
// For wide or narrow string objects, you can use the
|
2043
|
-
// {ASSERT|EXPECT}_??() macros.
|
2044
|
-
//
|
2045
|
-
// Don't depend on the order in which the arguments are evaluated,
|
2046
|
-
// which is undefined.
|
2047
|
-
//
|
2048
|
-
// These macros evaluate their arguments exactly once.
|
2049
|
-
|
2050
|
-
#define EXPECT_STREQ(expected, actual) \
|
2051
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)
|
2052
|
-
#define EXPECT_STRNE(s1, s2) \
|
2053
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
|
2054
|
-
#define EXPECT_STRCASEEQ(expected, actual) \
|
2055
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)
|
2056
|
-
#define EXPECT_STRCASENE(s1, s2)\
|
2057
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
|
2058
|
-
|
2059
|
-
#define ASSERT_STREQ(expected, actual) \
|
2060
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)
|
2061
|
-
#define ASSERT_STRNE(s1, s2) \
|
2062
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
|
2063
|
-
#define ASSERT_STRCASEEQ(expected, actual) \
|
2064
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)
|
2065
|
-
#define ASSERT_STRCASENE(s1, s2)\
|
2066
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
|
2067
|
-
|
2068
|
-
// Macros for comparing floating-point numbers.
|
2069
|
-
//
|
2070
|
-
// * {ASSERT|EXPECT}_FLOAT_EQ(expected, actual):
|
2071
|
-
// Tests that two float values are almost equal.
|
2072
|
-
// * {ASSERT|EXPECT}_DOUBLE_EQ(expected, actual):
|
2073
|
-
// Tests that two double values are almost equal.
|
2074
|
-
// * {ASSERT|EXPECT}_NEAR(v1, v2, abs_error):
|
2075
|
-
// Tests that v1 and v2 are within the given distance to each other.
|
2076
|
-
//
|
2077
|
-
// Google Test uses ULP-based comparison to automatically pick a default
|
2078
|
-
// error bound that is appropriate for the operands. See the
|
2079
|
-
// FloatingPoint template class in gtest-internal.h if you are
|
2080
|
-
// interested in the implementation details.
|
2081
|
-
|
2082
|
-
#define EXPECT_FLOAT_EQ(expected, actual)\
|
2083
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
|
2084
|
-
expected, actual)
|
2085
|
-
|
2086
|
-
#define EXPECT_DOUBLE_EQ(expected, actual)\
|
2087
|
-
EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
|
2088
|
-
expected, actual)
|
2089
|
-
|
2090
|
-
#define ASSERT_FLOAT_EQ(expected, actual)\
|
2091
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
|
2092
|
-
expected, actual)
|
2093
|
-
|
2094
|
-
#define ASSERT_DOUBLE_EQ(expected, actual)\
|
2095
|
-
ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
|
2096
|
-
expected, actual)
|
2097
|
-
|
2098
|
-
#define EXPECT_NEAR(val1, val2, abs_error)\
|
2099
|
-
EXPECT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \
|
2100
|
-
val1, val2, abs_error)
|
2101
|
-
|
2102
|
-
#define ASSERT_NEAR(val1, val2, abs_error)\
|
2103
|
-
ASSERT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \
|
2104
|
-
val1, val2, abs_error)
|
2105
|
-
|
2106
|
-
// These predicate format functions work on floating-point values, and
|
2107
|
-
// can be used in {ASSERT|EXPECT}_PRED_FORMAT2*(), e.g.
|
2108
|
-
//
|
2109
|
-
// EXPECT_PRED_FORMAT2(testing::DoubleLE, Foo(), 5.0);
|
2110
|
-
|
2111
|
-
// Asserts that val1 is less than, or almost equal to, val2. Fails
|
2112
|
-
// otherwise. In particular, it fails if either val1 or val2 is NaN.
|
2113
|
-
GTEST_API_ AssertionResult FloatLE(const char* expr1, const char* expr2,
|
2114
|
-
float val1, float val2);
|
2115
|
-
GTEST_API_ AssertionResult DoubleLE(const char* expr1, const char* expr2,
|
2116
|
-
double val1, double val2);
|
2117
|
-
|
2118
|
-
|
2119
|
-
#if GTEST_OS_WINDOWS
|
2120
|
-
|
2121
|
-
// Macros that test for HRESULT failure and success, these are only useful
|
2122
|
-
// on Windows, and rely on Windows SDK macros and APIs to compile.
|
2123
|
-
//
|
2124
|
-
// * {ASSERT|EXPECT}_HRESULT_{SUCCEEDED|FAILED}(expr)
|
2125
|
-
//
|
2126
|
-
// When expr unexpectedly fails or succeeds, Google Test prints the
|
2127
|
-
// expected result and the actual result with both a human-readable
|
2128
|
-
// string representation of the error, if available, as well as the
|
2129
|
-
// hex result code.
|
2130
|
-
# define EXPECT_HRESULT_SUCCEEDED(expr) \
|
2131
|
-
EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))
|
2132
|
-
|
2133
|
-
# define ASSERT_HRESULT_SUCCEEDED(expr) \
|
2134
|
-
ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))
|
2135
|
-
|
2136
|
-
# define EXPECT_HRESULT_FAILED(expr) \
|
2137
|
-
EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))
|
2138
|
-
|
2139
|
-
# define ASSERT_HRESULT_FAILED(expr) \
|
2140
|
-
ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))
|
2141
|
-
|
2142
|
-
#endif // GTEST_OS_WINDOWS
|
2143
|
-
|
2144
|
-
// Macros that execute statement and check that it doesn't generate new fatal
|
2145
|
-
// failures in the current thread.
|
2146
|
-
//
|
2147
|
-
// * {ASSERT|EXPECT}_NO_FATAL_FAILURE(statement);
|
2148
|
-
//
|
2149
|
-
// Examples:
|
2150
|
-
//
|
2151
|
-
// EXPECT_NO_FATAL_FAILURE(Process());
|
2152
|
-
// ASSERT_NO_FATAL_FAILURE(Process()) << "Process() failed";
|
2153
|
-
//
|
2154
|
-
#define ASSERT_NO_FATAL_FAILURE(statement) \
|
2155
|
-
GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)
|
2156
|
-
#define EXPECT_NO_FATAL_FAILURE(statement) \
|
2157
|
-
GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)
|
2158
|
-
|
2159
|
-
// Causes a trace (including the source file path, the current line
|
2160
|
-
// number, and the given message) to be included in every test failure
|
2161
|
-
// message generated by code in the current scope. The effect is
|
2162
|
-
// undone when the control leaves the current scope.
|
2163
|
-
//
|
2164
|
-
// The message argument can be anything streamable to std::ostream.
|
2165
|
-
//
|
2166
|
-
// In the implementation, we include the current line number as part
|
2167
|
-
// of the dummy variable name, thus allowing multiple SCOPED_TRACE()s
|
2168
|
-
// to appear in the same block - as long as they are on different
|
2169
|
-
// lines.
|
2170
|
-
#define SCOPED_TRACE(message) \
|
2171
|
-
::testing::internal::ScopedTrace GTEST_CONCAT_TOKEN_(gtest_trace_, __LINE__)(\
|
2172
|
-
__FILE__, __LINE__, ::testing::Message() << (message))
|
2173
|
-
|
2174
|
-
// Compile-time assertion for type equality.
|
2175
|
-
// StaticAssertTypeEq<type1, type2>() compiles iff type1 and type2 are
|
2176
|
-
// the same type. The value it returns is not interesting.
|
2177
|
-
//
|
2178
|
-
// Instead of making StaticAssertTypeEq a class template, we make it a
|
2179
|
-
// function template that invokes a helper class template. This
|
2180
|
-
// prevents a user from misusing StaticAssertTypeEq<T1, T2> by
|
2181
|
-
// defining objects of that type.
|
2182
|
-
//
|
2183
|
-
// CAVEAT:
|
2184
|
-
//
|
2185
|
-
// When used inside a method of a class template,
|
2186
|
-
// StaticAssertTypeEq<T1, T2>() is effective ONLY IF the method is
|
2187
|
-
// instantiated. For example, given:
|
2188
|
-
//
|
2189
|
-
// template <typename T> class Foo {
|
2190
|
-
// public:
|
2191
|
-
// void Bar() { testing::StaticAssertTypeEq<int, T>(); }
|
2192
|
-
// };
|
2193
|
-
//
|
2194
|
-
// the code:
|
2195
|
-
//
|
2196
|
-
// void Test1() { Foo<bool> foo; }
|
2197
|
-
//
|
2198
|
-
// will NOT generate a compiler error, as Foo<bool>::Bar() is never
|
2199
|
-
// actually instantiated. Instead, you need:
|
2200
|
-
//
|
2201
|
-
// void Test2() { Foo<bool> foo; foo.Bar(); }
|
2202
|
-
//
|
2203
|
-
// to cause a compiler error.
|
2204
|
-
template <typename T1, typename T2>
|
2205
|
-
bool StaticAssertTypeEq() {
|
2206
|
-
(void)internal::StaticAssertTypeEqHelper<T1, T2>();
|
2207
|
-
return true;
|
2208
|
-
}
|
2209
|
-
|
2210
|
-
// Defines a test.
|
2211
|
-
//
|
2212
|
-
// The first parameter is the name of the test case, and the second
|
2213
|
-
// parameter is the name of the test within the test case.
|
2214
|
-
//
|
2215
|
-
// The convention is to end the test case name with "Test". For
|
2216
|
-
// example, a test case for the Foo class can be named FooTest.
|
2217
|
-
//
|
2218
|
-
// The user should put his test code between braces after using this
|
2219
|
-
// macro. Example:
|
2220
|
-
//
|
2221
|
-
// TEST(FooTest, InitializesCorrectly) {
|
2222
|
-
// Foo foo;
|
2223
|
-
// EXPECT_TRUE(foo.StatusIsOK());
|
2224
|
-
// }
|
2225
|
-
|
2226
|
-
// Note that we call GetTestTypeId() instead of GetTypeId<
|
2227
|
-
// ::testing::Test>() here to get the type ID of testing::Test. This
|
2228
|
-
// is to work around a suspected linker bug when using Google Test as
|
2229
|
-
// a framework on Mac OS X. The bug causes GetTypeId<
|
2230
|
-
// ::testing::Test>() to return different values depending on whether
|
2231
|
-
// the call is from the Google Test framework itself or from user test
|
2232
|
-
// code. GetTestTypeId() is guaranteed to always return the same
|
2233
|
-
// value, as it always calls GetTypeId<>() from the Google Test
|
2234
|
-
// framework.
|
2235
|
-
#define GTEST_TEST(test_case_name, test_name)\
|
2236
|
-
GTEST_TEST_(test_case_name, test_name, \
|
2237
|
-
::testing::Test, ::testing::internal::GetTestTypeId())
|
2238
|
-
|
2239
|
-
// Define this macro to 1 to omit the definition of TEST(), which
|
2240
|
-
// is a generic name and clashes with some other libraries.
|
2241
|
-
#if !GTEST_DONT_DEFINE_TEST
|
2242
|
-
# define TEST(test_case_name, test_name) GTEST_TEST(test_case_name, test_name)
|
2243
|
-
#endif
|
2244
|
-
|
2245
|
-
// Defines a test that uses a test fixture.
|
2246
|
-
//
|
2247
|
-
// The first parameter is the name of the test fixture class, which
|
2248
|
-
// also doubles as the test case name. The second parameter is the
|
2249
|
-
// name of the test within the test case.
|
2250
|
-
//
|
2251
|
-
// A test fixture class must be declared earlier. The user should put
|
2252
|
-
// his test code between braces after using this macro. Example:
|
2253
|
-
//
|
2254
|
-
// class FooTest : public testing::Test {
|
2255
|
-
// protected:
|
2256
|
-
// virtual void SetUp() { b_.AddElement(3); }
|
2257
|
-
//
|
2258
|
-
// Foo a_;
|
2259
|
-
// Foo b_;
|
2260
|
-
// };
|
2261
|
-
//
|
2262
|
-
// TEST_F(FooTest, InitializesCorrectly) {
|
2263
|
-
// EXPECT_TRUE(a_.StatusIsOK());
|
2264
|
-
// }
|
2265
|
-
//
|
2266
|
-
// TEST_F(FooTest, ReturnsElementCountCorrectly) {
|
2267
|
-
// EXPECT_EQ(0, a_.size());
|
2268
|
-
// EXPECT_EQ(1, b_.size());
|
2269
|
-
// }
|
2270
|
-
|
2271
|
-
#define TEST_F(test_fixture, test_name)\
|
2272
|
-
GTEST_TEST_(test_fixture, test_name, test_fixture, \
|
2273
|
-
::testing::internal::GetTypeId<test_fixture>())
|
2274
|
-
|
2275
|
-
} // namespace testing
|
2276
|
-
|
2277
|
-
// Use this function in main() to run all tests. It returns 0 if all
|
2278
|
-
// tests are successful, or 1 otherwise.
|
2279
|
-
//
|
2280
|
-
// RUN_ALL_TESTS() should be invoked after the command line has been
|
2281
|
-
// parsed by InitGoogleTest().
|
2282
|
-
//
|
2283
|
-
// This function was formerly a macro; thus, it is in the global
|
2284
|
-
// namespace and has an all-caps name.
|
2285
|
-
int RUN_ALL_TESTS() GTEST_MUST_USE_RESULT_;
|
2286
|
-
|
2287
|
-
inline int RUN_ALL_TESTS() {
|
2288
|
-
return ::testing::UnitTest::GetInstance()->Run();
|
2289
|
-
}
|
2290
|
-
|
2291
|
-
#endif // GTEST_INCLUDE_GTEST_GTEST_H_
|