Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
freebsd
GitHub Repository: freebsd/freebsd-src
Path: blob/main/contrib/googletest/googlemock/test/gmock-spec-builders_test.cc
48255 views
1
// Copyright 2007, 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
// Google Mock - a framework for writing C++ mock classes.
31
//
32
// This file tests the spec builder syntax.
33
34
#include "gmock/gmock-spec-builders.h"
35
36
#include <memory>
37
#include <ostream> // NOLINT
38
#include <sstream>
39
#include <string>
40
#include <type_traits>
41
42
#include "gmock/gmock.h"
43
#include "gmock/internal/gmock-port.h"
44
#include "gtest/gtest-spi.h"
45
#include "gtest/gtest.h"
46
#include "gtest/internal/gtest-port.h"
47
48
namespace testing {
49
namespace {
50
51
using ::testing::internal::FormatFileLocation;
52
using ::testing::internal::kAllow;
53
using ::testing::internal::kErrorVerbosity;
54
using ::testing::internal::kFail;
55
using ::testing::internal::kInfoVerbosity;
56
using ::testing::internal::kWarn;
57
using ::testing::internal::kWarningVerbosity;
58
59
#if GTEST_HAS_STREAM_REDIRECTION
60
using ::testing::internal::CaptureStdout;
61
using ::testing::internal::GetCapturedStdout;
62
#endif
63
64
class Incomplete {
65
};
66
67
class MockIncomplete {
68
public:
69
// This line verifies that a mock method can take a by-reference
70
// argument of an incomplete type.
71
MOCK_METHOD1(ByRefFunc, void(const Incomplete& x));
72
};
73
74
// Tells Google Mock how to print a value of type Incomplete.
75
void PrintTo(const Incomplete& x, ::std::ostream* os);
76
77
TEST(MockMethodTest, CanInstantiateWithIncompleteArgType) {
78
// Even though this mock class contains a mock method that takes
79
// by-reference an argument whose type is incomplete, we can still
80
// use the mock, as long as Google Mock knows how to print the
81
// argument.
82
MockIncomplete incomplete;
83
EXPECT_CALL(incomplete, ByRefFunc(_)).Times(AnyNumber());
84
}
85
86
// The definition of the printer for the argument type doesn't have to
87
// be visible where the mock is used.
88
void PrintTo(const Incomplete& /* x */, ::std::ostream* os) {
89
*os << "incomplete";
90
}
91
92
class Result {};
93
94
// A type that's not default constructible.
95
class NonDefaultConstructible {
96
public:
97
explicit NonDefaultConstructible(int /* dummy */) {}
98
};
99
100
class MockA {
101
public:
102
MockA() = default;
103
104
MOCK_METHOD1(DoA, void(int n));
105
MOCK_METHOD1(ReturnResult, Result(int n));
106
MOCK_METHOD0(ReturnNonDefaultConstructible, NonDefaultConstructible());
107
MOCK_METHOD2(Binary, bool(int x, int y));
108
MOCK_METHOD2(ReturnInt, int(int x, int y));
109
110
private:
111
MockA(const MockA&) = delete;
112
MockA& operator=(const MockA&) = delete;
113
};
114
115
class MockB {
116
public:
117
MockB() = default;
118
119
MOCK_CONST_METHOD0(DoB, int()); // NOLINT
120
MOCK_METHOD1(DoB, int(int n)); // NOLINT
121
122
private:
123
MockB(const MockB&) = delete;
124
MockB& operator=(const MockB&) = delete;
125
};
126
127
class ReferenceHoldingMock {
128
public:
129
ReferenceHoldingMock() = default;
130
131
MOCK_METHOD1(AcceptReference, void(std::shared_ptr<MockA>*));
132
133
private:
134
ReferenceHoldingMock(const ReferenceHoldingMock&) = delete;
135
ReferenceHoldingMock& operator=(const ReferenceHoldingMock&) = delete;
136
};
137
138
// Tests that EXPECT_CALL and ON_CALL compile in a presence of macro
139
// redefining a mock method name. This could happen, for example, when
140
// the tested code #includes Win32 API headers which define many APIs
141
// as macros, e.g. #define TextOut TextOutW.
142
143
#define Method MethodW
144
145
class CC {
146
public:
147
virtual ~CC() = default;
148
virtual int Method() = 0;
149
};
150
class MockCC : public CC {
151
public:
152
MockCC() = default;
153
154
MOCK_METHOD0(Method, int());
155
156
private:
157
MockCC(const MockCC&) = delete;
158
MockCC& operator=(const MockCC&) = delete;
159
};
160
161
// Tests that a method with expanded name compiles.
162
TEST(OnCallSyntaxTest, CompilesWithMethodNameExpandedFromMacro) {
163
MockCC cc;
164
ON_CALL(cc, Method());
165
}
166
167
// Tests that the method with expanded name not only compiles but runs
168
// and returns a correct value, too.
169
TEST(OnCallSyntaxTest, WorksWithMethodNameExpandedFromMacro) {
170
MockCC cc;
171
ON_CALL(cc, Method()).WillByDefault(Return(42));
172
EXPECT_EQ(42, cc.Method());
173
}
174
175
// Tests that a method with expanded name compiles.
176
TEST(ExpectCallSyntaxTest, CompilesWithMethodNameExpandedFromMacro) {
177
MockCC cc;
178
EXPECT_CALL(cc, Method());
179
cc.Method();
180
}
181
182
// Tests that it works, too.
183
TEST(ExpectCallSyntaxTest, WorksWithMethodNameExpandedFromMacro) {
184
MockCC cc;
185
EXPECT_CALL(cc, Method()).WillOnce(Return(42));
186
EXPECT_EQ(42, cc.Method());
187
}
188
189
#undef Method // Done with macro redefinition tests.
190
191
// Tests that ON_CALL evaluates its arguments exactly once as promised
192
// by Google Mock.
193
TEST(OnCallSyntaxTest, EvaluatesFirstArgumentOnce) {
194
MockA a;
195
MockA* pa = &a;
196
197
ON_CALL(*pa++, DoA(_));
198
EXPECT_EQ(&a + 1, pa);
199
}
200
201
TEST(OnCallSyntaxTest, EvaluatesSecondArgumentOnce) {
202
MockA a;
203
int n = 0;
204
205
ON_CALL(a, DoA(n++));
206
EXPECT_EQ(1, n);
207
}
208
209
// Tests that the syntax of ON_CALL() is enforced at run time.
210
211
TEST(OnCallSyntaxTest, WithIsOptional) {
212
MockA a;
213
214
ON_CALL(a, DoA(5)).WillByDefault(Return());
215
ON_CALL(a, DoA(_)).With(_).WillByDefault(Return());
216
}
217
218
TEST(OnCallSyntaxTest, WithCanAppearAtMostOnce) {
219
MockA a;
220
221
EXPECT_NONFATAL_FAILURE(
222
{ // NOLINT
223
ON_CALL(a, ReturnResult(_))
224
.With(_)
225
.With(_)
226
.WillByDefault(Return(Result()));
227
},
228
".With() cannot appear more than once in an ON_CALL()");
229
}
230
231
TEST(OnCallSyntaxTest, WillByDefaultIsMandatory) {
232
MockA a;
233
234
EXPECT_DEATH_IF_SUPPORTED(
235
{
236
ON_CALL(a, DoA(5));
237
a.DoA(5);
238
},
239
"");
240
}
241
242
TEST(OnCallSyntaxTest, WillByDefaultCanAppearAtMostOnce) {
243
MockA a;
244
245
EXPECT_NONFATAL_FAILURE(
246
{ // NOLINT
247
ON_CALL(a, DoA(5)).WillByDefault(Return()).WillByDefault(Return());
248
},
249
".WillByDefault() must appear exactly once in an ON_CALL()");
250
}
251
252
// Tests that EXPECT_CALL evaluates its arguments exactly once as
253
// promised by Google Mock.
254
TEST(ExpectCallSyntaxTest, EvaluatesFirstArgumentOnce) {
255
MockA a;
256
MockA* pa = &a;
257
258
EXPECT_CALL(*pa++, DoA(_));
259
a.DoA(0);
260
EXPECT_EQ(&a + 1, pa);
261
}
262
263
TEST(ExpectCallSyntaxTest, EvaluatesSecondArgumentOnce) {
264
MockA a;
265
int n = 0;
266
267
EXPECT_CALL(a, DoA(n++));
268
a.DoA(0);
269
EXPECT_EQ(1, n);
270
}
271
272
// Tests that the syntax of EXPECT_CALL() is enforced at run time.
273
274
TEST(ExpectCallSyntaxTest, WithIsOptional) {
275
MockA a;
276
277
EXPECT_CALL(a, DoA(5)).Times(0);
278
EXPECT_CALL(a, DoA(6)).With(_).Times(0);
279
}
280
281
TEST(ExpectCallSyntaxTest, WithCanAppearAtMostOnce) {
282
MockA a;
283
284
EXPECT_NONFATAL_FAILURE(
285
{ // NOLINT
286
EXPECT_CALL(a, DoA(6)).With(_).With(_);
287
},
288
".With() cannot appear more than once in an EXPECT_CALL()");
289
290
a.DoA(6);
291
}
292
293
TEST(ExpectCallSyntaxTest, WithMustBeFirstClause) {
294
MockA a;
295
296
EXPECT_NONFATAL_FAILURE(
297
{ // NOLINT
298
EXPECT_CALL(a, DoA(1)).Times(1).With(_);
299
},
300
".With() must be the first clause in an EXPECT_CALL()");
301
302
a.DoA(1);
303
304
EXPECT_NONFATAL_FAILURE(
305
{ // NOLINT
306
EXPECT_CALL(a, DoA(2)).WillOnce(Return()).With(_);
307
},
308
".With() must be the first clause in an EXPECT_CALL()");
309
310
a.DoA(2);
311
}
312
313
TEST(ExpectCallSyntaxTest, TimesCanBeInferred) {
314
MockA a;
315
316
EXPECT_CALL(a, DoA(1)).WillOnce(Return());
317
318
EXPECT_CALL(a, DoA(2)).WillOnce(Return()).WillRepeatedly(Return());
319
320
a.DoA(1);
321
a.DoA(2);
322
a.DoA(2);
323
}
324
325
TEST(ExpectCallSyntaxTest, TimesCanAppearAtMostOnce) {
326
MockA a;
327
328
EXPECT_NONFATAL_FAILURE(
329
{ // NOLINT
330
EXPECT_CALL(a, DoA(1)).Times(1).Times(2);
331
},
332
".Times() cannot appear more than once in an EXPECT_CALL()");
333
334
a.DoA(1);
335
a.DoA(1);
336
}
337
338
TEST(ExpectCallSyntaxTest, TimesMustBeBeforeInSequence) {
339
MockA a;
340
Sequence s;
341
342
EXPECT_NONFATAL_FAILURE(
343
{ // NOLINT
344
EXPECT_CALL(a, DoA(1)).InSequence(s).Times(1);
345
},
346
".Times() may only appear *before* ");
347
348
a.DoA(1);
349
}
350
351
TEST(ExpectCallSyntaxTest, InSequenceIsOptional) {
352
MockA a;
353
Sequence s;
354
355
EXPECT_CALL(a, DoA(1));
356
EXPECT_CALL(a, DoA(2)).InSequence(s);
357
358
a.DoA(1);
359
a.DoA(2);
360
}
361
362
TEST(ExpectCallSyntaxTest, InSequenceCanAppearMultipleTimes) {
363
MockA a;
364
Sequence s1, s2;
365
366
EXPECT_CALL(a, DoA(1)).InSequence(s1, s2).InSequence(s1);
367
368
a.DoA(1);
369
}
370
371
TEST(ExpectCallSyntaxTest, InSequenceMustBeBeforeAfter) {
372
MockA a;
373
Sequence s;
374
375
Expectation e = EXPECT_CALL(a, DoA(1)).Times(AnyNumber());
376
EXPECT_NONFATAL_FAILURE(
377
{ // NOLINT
378
EXPECT_CALL(a, DoA(2)).After(e).InSequence(s);
379
},
380
".InSequence() cannot appear after ");
381
382
a.DoA(2);
383
}
384
385
TEST(ExpectCallSyntaxTest, InSequenceMustBeBeforeWillOnce) {
386
MockA a;
387
Sequence s;
388
389
EXPECT_NONFATAL_FAILURE(
390
{ // NOLINT
391
EXPECT_CALL(a, DoA(1)).WillOnce(Return()).InSequence(s);
392
},
393
".InSequence() cannot appear after ");
394
395
a.DoA(1);
396
}
397
398
TEST(ExpectCallSyntaxTest, AfterMustBeBeforeWillOnce) {
399
MockA a;
400
401
Expectation e = EXPECT_CALL(a, DoA(1));
402
EXPECT_NONFATAL_FAILURE(
403
{ EXPECT_CALL(a, DoA(2)).WillOnce(Return()).After(e); },
404
".After() cannot appear after ");
405
406
a.DoA(1);
407
a.DoA(2);
408
}
409
410
TEST(ExpectCallSyntaxTest, WillIsOptional) {
411
MockA a;
412
413
EXPECT_CALL(a, DoA(1));
414
EXPECT_CALL(a, DoA(2)).WillOnce(Return());
415
416
a.DoA(1);
417
a.DoA(2);
418
}
419
420
TEST(ExpectCallSyntaxTest, WillCanAppearMultipleTimes) {
421
MockA a;
422
423
EXPECT_CALL(a, DoA(1))
424
.Times(AnyNumber())
425
.WillOnce(Return())
426
.WillOnce(Return())
427
.WillOnce(Return());
428
}
429
430
TEST(ExpectCallSyntaxTest, WillMustBeBeforeWillRepeatedly) {
431
MockA a;
432
433
EXPECT_NONFATAL_FAILURE(
434
{ // NOLINT
435
EXPECT_CALL(a, DoA(1)).WillRepeatedly(Return()).WillOnce(Return());
436
},
437
".WillOnce() cannot appear after ");
438
439
a.DoA(1);
440
}
441
442
TEST(ExpectCallSyntaxTest, WillRepeatedlyIsOptional) {
443
MockA a;
444
445
EXPECT_CALL(a, DoA(1)).WillOnce(Return());
446
EXPECT_CALL(a, DoA(2)).WillOnce(Return()).WillRepeatedly(Return());
447
448
a.DoA(1);
449
a.DoA(2);
450
a.DoA(2);
451
}
452
453
TEST(ExpectCallSyntaxTest, WillRepeatedlyCannotAppearMultipleTimes) {
454
MockA a;
455
456
EXPECT_NONFATAL_FAILURE(
457
{ // NOLINT
458
EXPECT_CALL(a, DoA(1)).WillRepeatedly(Return()).WillRepeatedly(
459
Return());
460
},
461
".WillRepeatedly() cannot appear more than once in an "
462
"EXPECT_CALL()");
463
}
464
465
TEST(ExpectCallSyntaxTest, WillRepeatedlyMustBeBeforeRetiresOnSaturation) {
466
MockA a;
467
468
EXPECT_NONFATAL_FAILURE(
469
{ // NOLINT
470
EXPECT_CALL(a, DoA(1)).RetiresOnSaturation().WillRepeatedly(Return());
471
},
472
".WillRepeatedly() cannot appear after ");
473
}
474
475
TEST(ExpectCallSyntaxTest, RetiresOnSaturationIsOptional) {
476
MockA a;
477
478
EXPECT_CALL(a, DoA(1));
479
EXPECT_CALL(a, DoA(1)).RetiresOnSaturation();
480
481
a.DoA(1);
482
a.DoA(1);
483
}
484
485
TEST(ExpectCallSyntaxTest, RetiresOnSaturationCannotAppearMultipleTimes) {
486
MockA a;
487
488
EXPECT_NONFATAL_FAILURE(
489
{ // NOLINT
490
EXPECT_CALL(a, DoA(1)).RetiresOnSaturation().RetiresOnSaturation();
491
},
492
".RetiresOnSaturation() cannot appear more than once");
493
494
a.DoA(1);
495
}
496
497
TEST(ExpectCallSyntaxTest, DefaultCardinalityIsOnce) {
498
{
499
MockA a;
500
EXPECT_CALL(a, DoA(1));
501
a.DoA(1);
502
}
503
EXPECT_NONFATAL_FAILURE(
504
{ // NOLINT
505
MockA a;
506
EXPECT_CALL(a, DoA(1));
507
},
508
"to be called once");
509
EXPECT_NONFATAL_FAILURE(
510
{ // NOLINT
511
MockA a;
512
EXPECT_CALL(a, DoA(1));
513
a.DoA(1);
514
a.DoA(1);
515
},
516
"to be called once");
517
}
518
519
#if GTEST_HAS_STREAM_REDIRECTION
520
521
// Tests that Google Mock doesn't print a warning when the number of
522
// WillOnce() is adequate.
523
TEST(ExpectCallSyntaxTest, DoesNotWarnOnAdequateActionCount) {
524
CaptureStdout();
525
{
526
MockB b;
527
528
// It's always fine to omit WillOnce() entirely.
529
EXPECT_CALL(b, DoB()).Times(0);
530
EXPECT_CALL(b, DoB(1)).Times(AtMost(1));
531
EXPECT_CALL(b, DoB(2)).Times(1).WillRepeatedly(Return(1));
532
533
// It's fine for the number of WillOnce()s to equal the upper bound.
534
EXPECT_CALL(b, DoB(3))
535
.Times(Between(1, 2))
536
.WillOnce(Return(1))
537
.WillOnce(Return(2));
538
539
// It's fine for the number of WillOnce()s to be smaller than the
540
// upper bound when there is a WillRepeatedly().
541
EXPECT_CALL(b, DoB(4)).Times(AtMost(3)).WillOnce(Return(1)).WillRepeatedly(
542
Return(2));
543
544
// Satisfies the above expectations.
545
b.DoB(2);
546
b.DoB(3);
547
}
548
EXPECT_STREQ("", GetCapturedStdout().c_str());
549
}
550
551
// Tests that Google Mock warns on having too many actions in an
552
// expectation compared to its cardinality.
553
TEST(ExpectCallSyntaxTest, WarnsOnTooManyActions) {
554
CaptureStdout();
555
{
556
MockB b;
557
558
// Warns when the number of WillOnce()s is larger than the upper bound.
559
EXPECT_CALL(b, DoB()).Times(0).WillOnce(Return(1)); // #1
560
EXPECT_CALL(b, DoB()).Times(AtMost(1)).WillOnce(Return(1)).WillOnce(
561
Return(2)); // #2
562
EXPECT_CALL(b, DoB(1))
563
.Times(1)
564
.WillOnce(Return(1))
565
.WillOnce(Return(2))
566
.RetiresOnSaturation(); // #3
567
568
// Warns when the number of WillOnce()s equals the upper bound and
569
// there is a WillRepeatedly().
570
EXPECT_CALL(b, DoB()).Times(0).WillRepeatedly(Return(1)); // #4
571
EXPECT_CALL(b, DoB(2)).Times(1).WillOnce(Return(1)).WillRepeatedly(
572
Return(2)); // #5
573
574
// Satisfies the above expectations.
575
b.DoB(1);
576
b.DoB(2);
577
}
578
const std::string output = GetCapturedStdout();
579
EXPECT_PRED_FORMAT2(IsSubstring,
580
"Too many actions specified in EXPECT_CALL(b, DoB())...\n"
581
"Expected to be never called, but has 1 WillOnce().",
582
output); // #1
583
EXPECT_PRED_FORMAT2(IsSubstring,
584
"Too many actions specified in EXPECT_CALL(b, DoB())...\n"
585
"Expected to be called at most once, "
586
"but has 2 WillOnce()s.",
587
output); // #2
588
EXPECT_PRED_FORMAT2(
589
IsSubstring,
590
"Too many actions specified in EXPECT_CALL(b, DoB(1))...\n"
591
"Expected to be called once, but has 2 WillOnce()s.",
592
output); // #3
593
EXPECT_PRED_FORMAT2(IsSubstring,
594
"Too many actions specified in EXPECT_CALL(b, DoB())...\n"
595
"Expected to be never called, but has 0 WillOnce()s "
596
"and a WillRepeatedly().",
597
output); // #4
598
EXPECT_PRED_FORMAT2(
599
IsSubstring,
600
"Too many actions specified in EXPECT_CALL(b, DoB(2))...\n"
601
"Expected to be called once, but has 1 WillOnce() "
602
"and a WillRepeatedly().",
603
output); // #5
604
}
605
606
// Tests that Google Mock warns on having too few actions in an
607
// expectation compared to its cardinality.
608
TEST(ExpectCallSyntaxTest, WarnsOnTooFewActions) {
609
MockB b;
610
611
EXPECT_CALL(b, DoB()).Times(Between(2, 3)).WillOnce(Return(1));
612
613
CaptureStdout();
614
b.DoB();
615
const std::string output = GetCapturedStdout();
616
EXPECT_PRED_FORMAT2(IsSubstring,
617
"Too few actions specified in EXPECT_CALL(b, DoB())...\n"
618
"Expected to be called between 2 and 3 times, "
619
"but has only 1 WillOnce().",
620
output);
621
b.DoB();
622
}
623
624
TEST(ExpectCallSyntaxTest, WarningIsErrorWithFlag) {
625
int original_behavior = GMOCK_FLAG_GET(default_mock_behavior);
626
627
GMOCK_FLAG_SET(default_mock_behavior, kAllow);
628
CaptureStdout();
629
{
630
MockA a;
631
a.DoA(0);
632
}
633
std::string output = GetCapturedStdout();
634
EXPECT_TRUE(output.empty()) << output;
635
636
GMOCK_FLAG_SET(default_mock_behavior, kWarn);
637
CaptureStdout();
638
{
639
MockA a;
640
a.DoA(0);
641
}
642
std::string warning_output = GetCapturedStdout();
643
EXPECT_PRED_FORMAT2(IsSubstring, "GMOCK WARNING", warning_output);
644
EXPECT_PRED_FORMAT2(IsSubstring, "Uninteresting mock function call",
645
warning_output);
646
647
GMOCK_FLAG_SET(default_mock_behavior, kFail);
648
EXPECT_NONFATAL_FAILURE(
649
{
650
MockA a;
651
a.DoA(0);
652
},
653
"Uninteresting mock function call");
654
655
// Out of bounds values are converted to kWarn
656
GMOCK_FLAG_SET(default_mock_behavior, -1);
657
CaptureStdout();
658
{
659
MockA a;
660
a.DoA(0);
661
}
662
warning_output = GetCapturedStdout();
663
EXPECT_PRED_FORMAT2(IsSubstring, "GMOCK WARNING", warning_output);
664
EXPECT_PRED_FORMAT2(IsSubstring, "Uninteresting mock function call",
665
warning_output);
666
GMOCK_FLAG_SET(default_mock_behavior, 3);
667
CaptureStdout();
668
{
669
MockA a;
670
a.DoA(0);
671
}
672
warning_output = GetCapturedStdout();
673
EXPECT_PRED_FORMAT2(IsSubstring, "GMOCK WARNING", warning_output);
674
EXPECT_PRED_FORMAT2(IsSubstring, "Uninteresting mock function call",
675
warning_output);
676
677
GMOCK_FLAG_SET(default_mock_behavior, original_behavior);
678
}
679
680
#endif // GTEST_HAS_STREAM_REDIRECTION
681
682
// Tests the semantics of ON_CALL().
683
684
// Tests that the built-in default action is taken when no ON_CALL()
685
// is specified.
686
TEST(OnCallTest, TakesBuiltInDefaultActionWhenNoOnCall) {
687
MockB b;
688
EXPECT_CALL(b, DoB());
689
690
EXPECT_EQ(0, b.DoB());
691
}
692
693
// Tests that the built-in default action is taken when no ON_CALL()
694
// matches the invocation.
695
TEST(OnCallTest, TakesBuiltInDefaultActionWhenNoOnCallMatches) {
696
MockB b;
697
ON_CALL(b, DoB(1)).WillByDefault(Return(1));
698
EXPECT_CALL(b, DoB(_));
699
700
EXPECT_EQ(0, b.DoB(2));
701
}
702
703
// Tests that the last matching ON_CALL() action is taken.
704
TEST(OnCallTest, PicksLastMatchingOnCall) {
705
MockB b;
706
ON_CALL(b, DoB(_)).WillByDefault(Return(3));
707
ON_CALL(b, DoB(2)).WillByDefault(Return(2));
708
ON_CALL(b, DoB(1)).WillByDefault(Return(1));
709
EXPECT_CALL(b, DoB(_));
710
711
EXPECT_EQ(2, b.DoB(2));
712
}
713
714
// Tests the semantics of EXPECT_CALL().
715
716
// Tests that any call is allowed when no EXPECT_CALL() is specified.
717
TEST(ExpectCallTest, AllowsAnyCallWhenNoSpec) {
718
MockB b;
719
EXPECT_CALL(b, DoB());
720
// There is no expectation on DoB(int).
721
722
b.DoB();
723
724
// DoB(int) can be called any number of times.
725
b.DoB(1);
726
b.DoB(2);
727
}
728
729
// Tests that the last matching EXPECT_CALL() fires.
730
TEST(ExpectCallTest, PicksLastMatchingExpectCall) {
731
MockB b;
732
EXPECT_CALL(b, DoB(_)).WillRepeatedly(Return(2));
733
EXPECT_CALL(b, DoB(1)).WillRepeatedly(Return(1));
734
735
EXPECT_EQ(1, b.DoB(1));
736
}
737
738
// Tests lower-bound violation.
739
TEST(ExpectCallTest, CatchesTooFewCalls) {
740
EXPECT_NONFATAL_FAILURE(
741
{ // NOLINT
742
MockB b;
743
EXPECT_CALL(b, DoB(5)).Description("DoB Method").Times(AtLeast(2));
744
745
b.DoB(5);
746
},
747
"Actual function \"DoB Method\" call count "
748
"doesn't match EXPECT_CALL(b, DoB(5))...\n"
749
" Expected: to be called at least twice\n"
750
" Actual: called once - unsatisfied and active");
751
}
752
753
// Tests that the cardinality can be inferred when no Times(...) is
754
// specified.
755
TEST(ExpectCallTest, InfersCardinalityWhenThereIsNoWillRepeatedly) {
756
{
757
MockB b;
758
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillOnce(Return(2));
759
760
EXPECT_EQ(1, b.DoB());
761
EXPECT_EQ(2, b.DoB());
762
}
763
764
EXPECT_NONFATAL_FAILURE(
765
{ // NOLINT
766
MockB b;
767
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillOnce(Return(2));
768
769
EXPECT_EQ(1, b.DoB());
770
},
771
"to be called twice");
772
773
{ // NOLINT
774
MockB b;
775
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillOnce(Return(2));
776
777
EXPECT_EQ(1, b.DoB());
778
EXPECT_EQ(2, b.DoB());
779
EXPECT_NONFATAL_FAILURE(b.DoB(), "to be called twice");
780
}
781
}
782
783
TEST(ExpectCallTest, InfersCardinality1WhenThereIsWillRepeatedly) {
784
{
785
MockB b;
786
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillRepeatedly(Return(2));
787
788
EXPECT_EQ(1, b.DoB());
789
}
790
791
{ // NOLINT
792
MockB b;
793
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillRepeatedly(Return(2));
794
795
EXPECT_EQ(1, b.DoB());
796
EXPECT_EQ(2, b.DoB());
797
EXPECT_EQ(2, b.DoB());
798
}
799
800
EXPECT_NONFATAL_FAILURE(
801
{ // NOLINT
802
MockB b;
803
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillRepeatedly(Return(2));
804
},
805
"to be called at least once");
806
}
807
808
#if defined(GTEST_INTERNAL_CPLUSPLUS_LANG) && \
809
GTEST_INTERNAL_CPLUSPLUS_LANG >= 201703L
810
811
// It should be possible to return a non-moveable type from a mock action in
812
// C++17 and above, where it's guaranteed that such a type can be initialized
813
// from a prvalue returned from a function.
814
TEST(ExpectCallTest, NonMoveableType) {
815
// Define a non-moveable result type.
816
struct NonMoveableStruct {
817
explicit NonMoveableStruct(int x_in) : x(x_in) {}
818
NonMoveableStruct(NonMoveableStruct&&) = delete;
819
820
int x;
821
};
822
823
static_assert(!std::is_move_constructible_v<NonMoveableStruct>);
824
static_assert(!std::is_copy_constructible_v<NonMoveableStruct>);
825
826
static_assert(!std::is_move_assignable_v<NonMoveableStruct>);
827
static_assert(!std::is_copy_assignable_v<NonMoveableStruct>);
828
829
// We should be able to use a callable that returns that result as both a
830
// OnceAction and an Action, whether the callable ignores arguments or not.
831
const auto return_17 = [] { return NonMoveableStruct(17); };
832
833
static_cast<void>(OnceAction<NonMoveableStruct()>{return_17});
834
static_cast<void>(Action<NonMoveableStruct()>{return_17});
835
836
static_cast<void>(OnceAction<NonMoveableStruct(int)>{return_17});
837
static_cast<void>(Action<NonMoveableStruct(int)>{return_17});
838
839
// It should be possible to return the result end to end through an
840
// EXPECT_CALL statement, with both WillOnce and WillRepeatedly.
841
MockFunction<NonMoveableStruct()> mock;
842
EXPECT_CALL(mock, Call) //
843
.WillOnce(return_17) //
844
.WillRepeatedly(return_17);
845
846
EXPECT_EQ(17, mock.AsStdFunction()().x);
847
EXPECT_EQ(17, mock.AsStdFunction()().x);
848
EXPECT_EQ(17, mock.AsStdFunction()().x);
849
}
850
851
#endif // C++17 and above
852
853
// Tests that the n-th action is taken for the n-th matching
854
// invocation.
855
TEST(ExpectCallTest, NthMatchTakesNthAction) {
856
MockB b;
857
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillOnce(Return(2)).WillOnce(
858
Return(3));
859
860
EXPECT_EQ(1, b.DoB());
861
EXPECT_EQ(2, b.DoB());
862
EXPECT_EQ(3, b.DoB());
863
}
864
865
// Tests that the WillRepeatedly() action is taken when the WillOnce(...)
866
// list is exhausted.
867
TEST(ExpectCallTest, TakesRepeatedActionWhenWillListIsExhausted) {
868
MockB b;
869
EXPECT_CALL(b, DoB()).WillOnce(Return(1)).WillRepeatedly(Return(2));
870
871
EXPECT_EQ(1, b.DoB());
872
EXPECT_EQ(2, b.DoB());
873
EXPECT_EQ(2, b.DoB());
874
}
875
876
#if GTEST_HAS_STREAM_REDIRECTION
877
878
// Tests that the default action is taken when the WillOnce(...) list is
879
// exhausted and there is no WillRepeatedly().
880
TEST(ExpectCallTest, TakesDefaultActionWhenWillListIsExhausted) {
881
MockB b;
882
EXPECT_CALL(b, DoB(_)).Times(1);
883
EXPECT_CALL(b, DoB())
884
.Times(AnyNumber())
885
.WillOnce(Return(1))
886
.WillOnce(Return(2));
887
888
CaptureStdout();
889
EXPECT_EQ(0, b.DoB(1)); // Shouldn't generate a warning as the
890
// expectation has no action clause at all.
891
EXPECT_EQ(1, b.DoB());
892
EXPECT_EQ(2, b.DoB());
893
const std::string output1 = GetCapturedStdout();
894
EXPECT_STREQ("", output1.c_str());
895
896
CaptureStdout();
897
EXPECT_EQ(0, b.DoB());
898
EXPECT_EQ(0, b.DoB());
899
const std::string output2 = GetCapturedStdout();
900
EXPECT_THAT(output2.c_str(),
901
HasSubstr("Actions ran out in EXPECT_CALL(b, DoB())...\n"
902
"Called 3 times, but only 2 WillOnce()s are specified"
903
" - returning default value."));
904
EXPECT_THAT(output2.c_str(),
905
HasSubstr("Actions ran out in EXPECT_CALL(b, DoB())...\n"
906
"Called 4 times, but only 2 WillOnce()s are specified"
907
" - returning default value."));
908
}
909
910
TEST(FunctionMockerMessageTest, ReportsExpectCallLocationForExhaustedActions) {
911
MockB b;
912
std::string expect_call_location = FormatFileLocation(__FILE__, __LINE__ + 1);
913
EXPECT_CALL(b, DoB()).Times(AnyNumber()).WillOnce(Return(1));
914
915
EXPECT_EQ(1, b.DoB());
916
917
CaptureStdout();
918
EXPECT_EQ(0, b.DoB());
919
const std::string output = GetCapturedStdout();
920
// The warning message should contain the call location.
921
EXPECT_PRED_FORMAT2(IsSubstring, expect_call_location, output);
922
}
923
924
TEST(FunctionMockerMessageTest,
925
ReportsDefaultActionLocationOfUninterestingCallsForNaggyMock) {
926
std::string on_call_location;
927
CaptureStdout();
928
{
929
NaggyMock<MockB> b;
930
on_call_location = FormatFileLocation(__FILE__, __LINE__ + 1);
931
ON_CALL(b, DoB(_)).WillByDefault(Return(0));
932
b.DoB(0);
933
}
934
EXPECT_PRED_FORMAT2(IsSubstring, on_call_location, GetCapturedStdout());
935
}
936
937
#endif // GTEST_HAS_STREAM_REDIRECTION
938
939
// Tests that an uninteresting call performs the default action.
940
TEST(UninterestingCallTest, DoesDefaultAction) {
941
// When there is an ON_CALL() statement, the action specified by it
942
// should be taken.
943
MockA a;
944
ON_CALL(a, Binary(_, _)).WillByDefault(Return(true));
945
EXPECT_TRUE(a.Binary(1, 2));
946
947
// When there is no ON_CALL(), the default value for the return type
948
// should be returned.
949
MockB b;
950
EXPECT_EQ(0, b.DoB());
951
}
952
953
// Tests that an unexpected call performs the default action.
954
TEST(UnexpectedCallTest, DoesDefaultAction) {
955
// When there is an ON_CALL() statement, the action specified by it
956
// should be taken.
957
MockA a;
958
ON_CALL(a, Binary(_, _)).WillByDefault(Return(true));
959
EXPECT_CALL(a, Binary(0, 0));
960
a.Binary(0, 0);
961
bool result = false;
962
EXPECT_NONFATAL_FAILURE(result = a.Binary(1, 2),
963
"Unexpected mock function call");
964
EXPECT_TRUE(result);
965
966
// When there is no ON_CALL(), the default value for the return type
967
// should be returned.
968
MockB b;
969
EXPECT_CALL(b, DoB(0)).Times(0);
970
int n = -1;
971
EXPECT_NONFATAL_FAILURE(n = b.DoB(1), "Unexpected mock function call");
972
EXPECT_EQ(0, n);
973
}
974
975
// Tests that when an unexpected void function generates the right
976
// failure message.
977
TEST(UnexpectedCallTest, GeneratesFailureForVoidFunction) {
978
// First, tests the message when there is only one EXPECT_CALL().
979
MockA a1;
980
EXPECT_CALL(a1, DoA(1));
981
a1.DoA(1);
982
// Ideally we should match the failure message against a regex, but
983
// EXPECT_NONFATAL_FAILURE doesn't support that, so we test for
984
// multiple sub-strings instead.
985
EXPECT_NONFATAL_FAILURE(
986
a1.DoA(9),
987
"Unexpected mock function call - returning directly.\n"
988
" Function call: DoA(9)\n"
989
"Google Mock tried the following 1 expectation, but it didn't match:");
990
EXPECT_NONFATAL_FAILURE(
991
a1.DoA(9),
992
" Expected arg #0: is equal to 1\n"
993
" Actual: 9\n"
994
" Expected: to be called once\n"
995
" Actual: called once - saturated and active");
996
997
// Next, tests the message when there are more than one EXPECT_CALL().
998
MockA a2;
999
EXPECT_CALL(a2, DoA(1));
1000
EXPECT_CALL(a2, DoA(3));
1001
a2.DoA(1);
1002
EXPECT_NONFATAL_FAILURE(
1003
a2.DoA(2),
1004
"Unexpected mock function call - returning directly.\n"
1005
" Function call: DoA(2)\n"
1006
"Google Mock tried the following 2 expectations, but none matched:");
1007
EXPECT_NONFATAL_FAILURE(
1008
a2.DoA(2),
1009
"tried expectation #0: EXPECT_CALL(a2, DoA(1))...\n"
1010
" Expected arg #0: is equal to 1\n"
1011
" Actual: 2\n"
1012
" Expected: to be called once\n"
1013
" Actual: called once - saturated and active");
1014
EXPECT_NONFATAL_FAILURE(
1015
a2.DoA(2),
1016
"tried expectation #1: EXPECT_CALL(a2, DoA(3))...\n"
1017
" Expected arg #0: is equal to 3\n"
1018
" Actual: 2\n"
1019
" Expected: to be called once\n"
1020
" Actual: never called - unsatisfied and active");
1021
a2.DoA(3);
1022
}
1023
1024
// Tests that an unexpected non-void function generates the right
1025
// failure message.
1026
TEST(UnexpectedCallTest, GeneartesFailureForNonVoidFunction) {
1027
MockB b1;
1028
EXPECT_CALL(b1, DoB(1));
1029
b1.DoB(1);
1030
EXPECT_NONFATAL_FAILURE(
1031
b1.DoB(2),
1032
"Unexpected mock function call - returning default value.\n"
1033
" Function call: DoB(2)\n"
1034
" Returns: 0\n"
1035
"Google Mock tried the following 1 expectation, but it didn't match:");
1036
EXPECT_NONFATAL_FAILURE(
1037
b1.DoB(2),
1038
" Expected arg #0: is equal to 1\n"
1039
" Actual: 2\n"
1040
" Expected: to be called once\n"
1041
" Actual: called once - saturated and active");
1042
}
1043
1044
// Tests that Google Mock explains that an retired expectation doesn't
1045
// match the call.
1046
TEST(UnexpectedCallTest, RetiredExpectation) {
1047
MockB b;
1048
EXPECT_CALL(b, DoB(1)).RetiresOnSaturation();
1049
1050
b.DoB(1);
1051
EXPECT_NONFATAL_FAILURE(b.DoB(1),
1052
" Expected: the expectation is active\n"
1053
" Actual: it is retired");
1054
}
1055
1056
// Tests that Google Mock explains that an expectation that doesn't
1057
// match the arguments doesn't match the call.
1058
TEST(UnexpectedCallTest, UnmatchedArguments) {
1059
MockB b;
1060
EXPECT_CALL(b, DoB(1));
1061
1062
EXPECT_NONFATAL_FAILURE(b.DoB(2),
1063
" Expected arg #0: is equal to 1\n"
1064
" Actual: 2\n");
1065
b.DoB(1);
1066
}
1067
1068
// Tests that Google Mock explains that an expectation with
1069
// unsatisfied pre-requisites doesn't match the call.
1070
TEST(UnexpectedCallTest, UnsatisfiedPrerequisites) {
1071
Sequence s1, s2;
1072
MockB b;
1073
EXPECT_CALL(b, DoB(1)).InSequence(s1);
1074
EXPECT_CALL(b, DoB(2)).Times(AnyNumber()).InSequence(s1);
1075
EXPECT_CALL(b, DoB(3)).InSequence(s2);
1076
EXPECT_CALL(b, DoB(4)).InSequence(s1, s2);
1077
1078
::testing::TestPartResultArray failures;
1079
{
1080
::testing::ScopedFakeTestPartResultReporter reporter(&failures);
1081
b.DoB(4);
1082
// Now 'failures' contains the Google Test failures generated by
1083
// the above statement.
1084
}
1085
1086
// There should be one non-fatal failure.
1087
ASSERT_EQ(1, failures.size());
1088
const ::testing::TestPartResult& r = failures.GetTestPartResult(0);
1089
EXPECT_EQ(::testing::TestPartResult::kNonFatalFailure, r.type());
1090
1091
// Verifies that the failure message contains the two unsatisfied
1092
// pre-requisites but not the satisfied one.
1093
#ifdef GTEST_USES_POSIX_RE
1094
EXPECT_THAT(r.message(),
1095
ContainsRegex(
1096
// POSIX RE doesn't understand the (?s) prefix, but has no
1097
// trouble with (.|\n).
1098
"the following immediate pre-requisites are not satisfied:\n"
1099
"(.|\n)*: pre-requisite #0\n"
1100
"(.|\n)*: pre-requisite #1"));
1101
#else
1102
// We can only use Google Test's own simple regex.
1103
EXPECT_THAT(r.message(),
1104
ContainsRegex(
1105
"the following immediate pre-requisites are not satisfied:"));
1106
EXPECT_THAT(r.message(), ContainsRegex(": pre-requisite #0"));
1107
EXPECT_THAT(r.message(), ContainsRegex(": pre-requisite #1"));
1108
#endif // GTEST_USES_POSIX_RE
1109
1110
b.DoB(1);
1111
b.DoB(3);
1112
b.DoB(4);
1113
}
1114
1115
TEST(UndefinedReturnValueTest,
1116
ReturnValueIsMandatoryWhenNotDefaultConstructible) {
1117
MockA a;
1118
// FIXME: We should really verify the output message,
1119
// but we cannot yet due to that EXPECT_DEATH only captures stderr
1120
// while Google Mock logs to stdout.
1121
#if GTEST_HAS_EXCEPTIONS
1122
EXPECT_ANY_THROW(a.ReturnNonDefaultConstructible());
1123
#else
1124
EXPECT_DEATH_IF_SUPPORTED(a.ReturnNonDefaultConstructible(), "");
1125
#endif
1126
}
1127
1128
// Tests that an excessive call (one whose arguments match the
1129
// matchers but is called too many times) performs the default action.
1130
TEST(ExcessiveCallTest, DoesDefaultAction) {
1131
// When there is an ON_CALL() statement, the action specified by it
1132
// should be taken.
1133
MockA a;
1134
ON_CALL(a, Binary(_, _)).WillByDefault(Return(true));
1135
EXPECT_CALL(a, Binary(0, 0));
1136
a.Binary(0, 0);
1137
bool result = false;
1138
EXPECT_NONFATAL_FAILURE(result = a.Binary(0, 0),
1139
"Mock function called more times than expected");
1140
EXPECT_TRUE(result);
1141
1142
// When there is no ON_CALL(), the default value for the return type
1143
// should be returned.
1144
MockB b;
1145
EXPECT_CALL(b, DoB(0)).Description("DoB Method").Times(0);
1146
int n = -1;
1147
EXPECT_NONFATAL_FAILURE(
1148
n = b.DoB(0),
1149
"Mock function \"DoB Method\" called more times than expected");
1150
EXPECT_EQ(0, n);
1151
}
1152
1153
// Tests that when a void function is called too many times,
1154
// the failure message contains the argument values.
1155
TEST(ExcessiveCallTest, GeneratesFailureForVoidFunction) {
1156
MockA a;
1157
EXPECT_CALL(a, DoA(_)).Description("DoA Method").Times(0);
1158
EXPECT_NONFATAL_FAILURE(
1159
a.DoA(9),
1160
"Mock function \"DoA Method\" called more times than expected - "
1161
"returning directly.\n"
1162
" Function call: DoA(9)\n"
1163
" Expected: to be never called\n"
1164
" Actual: called once - over-saturated and active");
1165
}
1166
1167
// Tests that when a non-void function is called too many times, the
1168
// failure message contains the argument values and the return value.
1169
TEST(ExcessiveCallTest, GeneratesFailureForNonVoidFunction) {
1170
MockB b;
1171
EXPECT_CALL(b, DoB(_));
1172
b.DoB(1);
1173
EXPECT_NONFATAL_FAILURE(
1174
b.DoB(2),
1175
"Mock function called more times than expected - "
1176
"returning default value.\n"
1177
" Function call: DoB(2)\n"
1178
" Returns: 0\n"
1179
" Expected: to be called once\n"
1180
" Actual: called twice - over-saturated and active");
1181
}
1182
1183
// Tests using sequences.
1184
1185
TEST(InSequenceTest, AllExpectationInScopeAreInSequence) {
1186
MockA a;
1187
{
1188
InSequence dummy;
1189
1190
EXPECT_CALL(a, DoA(1));
1191
EXPECT_CALL(a, DoA(2));
1192
}
1193
1194
EXPECT_NONFATAL_FAILURE(
1195
{ // NOLINT
1196
a.DoA(2);
1197
},
1198
"Unexpected mock function call");
1199
1200
a.DoA(1);
1201
a.DoA(2);
1202
}
1203
1204
TEST(InSequenceTest, NestedInSequence) {
1205
MockA a;
1206
{
1207
InSequence dummy;
1208
1209
EXPECT_CALL(a, DoA(1));
1210
{
1211
InSequence dummy2;
1212
1213
EXPECT_CALL(a, DoA(2));
1214
EXPECT_CALL(a, DoA(3));
1215
}
1216
}
1217
1218
EXPECT_NONFATAL_FAILURE(
1219
{ // NOLINT
1220
a.DoA(1);
1221
a.DoA(3);
1222
},
1223
"Unexpected mock function call");
1224
1225
a.DoA(2);
1226
a.DoA(3);
1227
}
1228
1229
TEST(InSequenceTest, ExpectationsOutOfScopeAreNotAffected) {
1230
MockA a;
1231
{
1232
InSequence dummy;
1233
1234
EXPECT_CALL(a, DoA(1));
1235
EXPECT_CALL(a, DoA(2));
1236
}
1237
EXPECT_CALL(a, DoA(3));
1238
1239
EXPECT_NONFATAL_FAILURE(
1240
{ // NOLINT
1241
a.DoA(2);
1242
},
1243
"Unexpected mock function call");
1244
1245
a.DoA(3);
1246
a.DoA(1);
1247
a.DoA(2);
1248
}
1249
1250
// Tests that any order is allowed when no sequence is used.
1251
TEST(SequenceTest, AnyOrderIsOkByDefault) {
1252
{
1253
MockA a;
1254
MockB b;
1255
1256
EXPECT_CALL(a, DoA(1));
1257
EXPECT_CALL(b, DoB()).Times(AnyNumber());
1258
1259
a.DoA(1);
1260
b.DoB();
1261
}
1262
1263
{ // NOLINT
1264
MockA a;
1265
MockB b;
1266
1267
EXPECT_CALL(a, DoA(1));
1268
EXPECT_CALL(b, DoB()).Times(AnyNumber());
1269
1270
b.DoB();
1271
a.DoA(1);
1272
}
1273
}
1274
1275
// Tests that the calls must be in strict order when a complete order
1276
// is specified.
1277
TEST(SequenceTest, CallsMustBeInStrictOrderWhenSaidSo1) {
1278
MockA a;
1279
ON_CALL(a, ReturnResult(_)).WillByDefault(Return(Result()));
1280
1281
Sequence s;
1282
EXPECT_CALL(a, ReturnResult(1)).InSequence(s);
1283
EXPECT_CALL(a, ReturnResult(2)).InSequence(s);
1284
EXPECT_CALL(a, ReturnResult(3)).InSequence(s);
1285
1286
a.ReturnResult(1);
1287
1288
// May only be called after a.ReturnResult(2).
1289
EXPECT_NONFATAL_FAILURE(a.ReturnResult(3), "Unexpected mock function call");
1290
1291
a.ReturnResult(2);
1292
a.ReturnResult(3);
1293
}
1294
1295
// Tests that the calls must be in strict order when a complete order
1296
// is specified.
1297
TEST(SequenceTest, CallsMustBeInStrictOrderWhenSaidSo2) {
1298
MockA a;
1299
ON_CALL(a, ReturnResult(_)).WillByDefault(Return(Result()));
1300
1301
Sequence s;
1302
EXPECT_CALL(a, ReturnResult(1)).InSequence(s);
1303
EXPECT_CALL(a, ReturnResult(2)).InSequence(s);
1304
1305
// May only be called after a.ReturnResult(1).
1306
EXPECT_NONFATAL_FAILURE(a.ReturnResult(2), "Unexpected mock function call");
1307
1308
a.ReturnResult(1);
1309
a.ReturnResult(2);
1310
}
1311
1312
// Tests specifying a DAG using multiple sequences.
1313
class PartialOrderTest : public testing::Test {
1314
protected:
1315
PartialOrderTest() {
1316
ON_CALL(a_, ReturnResult(_)).WillByDefault(Return(Result()));
1317
1318
// Specifies this partial ordering:
1319
//
1320
// a.ReturnResult(1) ==>
1321
// a.ReturnResult(2) * n ==> a.ReturnResult(3)
1322
// b.DoB() * 2 ==>
1323
Sequence x, y;
1324
EXPECT_CALL(a_, ReturnResult(1)).InSequence(x);
1325
EXPECT_CALL(b_, DoB()).Times(2).InSequence(y);
1326
EXPECT_CALL(a_, ReturnResult(2)).Times(AnyNumber()).InSequence(x, y);
1327
EXPECT_CALL(a_, ReturnResult(3)).InSequence(x);
1328
}
1329
1330
MockA a_;
1331
MockB b_;
1332
};
1333
1334
TEST_F(PartialOrderTest, CallsMustConformToSpecifiedDag1) {
1335
a_.ReturnResult(1);
1336
b_.DoB();
1337
1338
// May only be called after the second DoB().
1339
EXPECT_NONFATAL_FAILURE(a_.ReturnResult(2), "Unexpected mock function call");
1340
1341
b_.DoB();
1342
a_.ReturnResult(3);
1343
}
1344
1345
TEST_F(PartialOrderTest, CallsMustConformToSpecifiedDag2) {
1346
// May only be called after ReturnResult(1).
1347
EXPECT_NONFATAL_FAILURE(a_.ReturnResult(2), "Unexpected mock function call");
1348
1349
a_.ReturnResult(1);
1350
b_.DoB();
1351
b_.DoB();
1352
a_.ReturnResult(3);
1353
}
1354
1355
TEST_F(PartialOrderTest, CallsMustConformToSpecifiedDag3) {
1356
// May only be called last.
1357
EXPECT_NONFATAL_FAILURE(a_.ReturnResult(3), "Unexpected mock function call");
1358
1359
a_.ReturnResult(1);
1360
b_.DoB();
1361
b_.DoB();
1362
a_.ReturnResult(3);
1363
}
1364
1365
TEST_F(PartialOrderTest, CallsMustConformToSpecifiedDag4) {
1366
a_.ReturnResult(1);
1367
b_.DoB();
1368
b_.DoB();
1369
a_.ReturnResult(3);
1370
1371
// May only be called before ReturnResult(3).
1372
EXPECT_NONFATAL_FAILURE(a_.ReturnResult(2), "Unexpected mock function call");
1373
}
1374
1375
TEST(SequenceTest, Retirement) {
1376
MockA a;
1377
Sequence s;
1378
1379
EXPECT_CALL(a, DoA(1)).InSequence(s);
1380
EXPECT_CALL(a, DoA(_)).InSequence(s).RetiresOnSaturation();
1381
EXPECT_CALL(a, DoA(1)).InSequence(s);
1382
1383
a.DoA(1);
1384
a.DoA(2);
1385
a.DoA(1);
1386
}
1387
1388
// Tests Expectation.
1389
1390
TEST(ExpectationTest, ConstrutorsWork) {
1391
MockA a;
1392
Expectation e1; // Default ctor.
1393
1394
// Ctor from various forms of EXPECT_CALL.
1395
Expectation e2 = EXPECT_CALL(a, DoA(2));
1396
Expectation e3 = EXPECT_CALL(a, DoA(3)).With(_);
1397
{
1398
Sequence s;
1399
Expectation e4 = EXPECT_CALL(a, DoA(4)).Times(1);
1400
Expectation e5 = EXPECT_CALL(a, DoA(5)).InSequence(s);
1401
}
1402
Expectation e6 = EXPECT_CALL(a, DoA(6)).After(e2);
1403
Expectation e7 = EXPECT_CALL(a, DoA(7)).WillOnce(Return());
1404
Expectation e8 = EXPECT_CALL(a, DoA(8)).WillRepeatedly(Return());
1405
Expectation e9 = EXPECT_CALL(a, DoA(9)).RetiresOnSaturation();
1406
1407
Expectation e10 = e2; // Copy ctor.
1408
1409
EXPECT_THAT(e1, Ne(e2));
1410
EXPECT_THAT(e2, Eq(e10));
1411
1412
a.DoA(2);
1413
a.DoA(3);
1414
a.DoA(4);
1415
a.DoA(5);
1416
a.DoA(6);
1417
a.DoA(7);
1418
a.DoA(8);
1419
a.DoA(9);
1420
}
1421
1422
TEST(ExpectationTest, AssignmentWorks) {
1423
MockA a;
1424
Expectation e1;
1425
Expectation e2 = EXPECT_CALL(a, DoA(1));
1426
1427
EXPECT_THAT(e1, Ne(e2));
1428
1429
e1 = e2;
1430
EXPECT_THAT(e1, Eq(e2));
1431
1432
a.DoA(1);
1433
}
1434
1435
// Tests ExpectationSet.
1436
1437
TEST(ExpectationSetTest, MemberTypesAreCorrect) {
1438
::testing::StaticAssertTypeEq<Expectation, ExpectationSet::value_type>();
1439
}
1440
1441
TEST(ExpectationSetTest, ConstructorsWork) {
1442
MockA a;
1443
1444
Expectation e1;
1445
const Expectation e2;
1446
ExpectationSet es1; // Default ctor.
1447
ExpectationSet es2 = EXPECT_CALL(a, DoA(1)); // Ctor from EXPECT_CALL.
1448
ExpectationSet es3 = e1; // Ctor from Expectation.
1449
ExpectationSet es4(e1); // Ctor from Expectation; alternative syntax.
1450
ExpectationSet es5 = e2; // Ctor from const Expectation.
1451
ExpectationSet es6(e2); // Ctor from const Expectation; alternative syntax.
1452
ExpectationSet es7 = es2; // Copy ctor.
1453
1454
EXPECT_EQ(0, es1.size());
1455
EXPECT_EQ(1, es2.size());
1456
EXPECT_EQ(1, es3.size());
1457
EXPECT_EQ(1, es4.size());
1458
EXPECT_EQ(1, es5.size());
1459
EXPECT_EQ(1, es6.size());
1460
EXPECT_EQ(1, es7.size());
1461
1462
EXPECT_THAT(es3, Ne(es2));
1463
EXPECT_THAT(es4, Eq(es3));
1464
EXPECT_THAT(es5, Eq(es4));
1465
EXPECT_THAT(es6, Eq(es5));
1466
EXPECT_THAT(es7, Eq(es2));
1467
a.DoA(1);
1468
}
1469
1470
TEST(ExpectationSetTest, AssignmentWorks) {
1471
ExpectationSet es1;
1472
ExpectationSet es2 = Expectation();
1473
1474
es1 = es2;
1475
EXPECT_EQ(1, es1.size());
1476
EXPECT_THAT(*(es1.begin()), Eq(Expectation()));
1477
EXPECT_THAT(es1, Eq(es2));
1478
}
1479
1480
TEST(ExpectationSetTest, InsertionWorks) {
1481
ExpectationSet es1;
1482
Expectation e1;
1483
es1 += e1;
1484
EXPECT_EQ(1, es1.size());
1485
EXPECT_THAT(*(es1.begin()), Eq(e1));
1486
1487
MockA a;
1488
Expectation e2 = EXPECT_CALL(a, DoA(1));
1489
es1 += e2;
1490
EXPECT_EQ(2, es1.size());
1491
1492
ExpectationSet::const_iterator it1 = es1.begin();
1493
ExpectationSet::const_iterator it2 = it1;
1494
++it2;
1495
EXPECT_TRUE(*it1 == e1 || *it2 == e1); // e1 must be in the set.
1496
EXPECT_TRUE(*it1 == e2 || *it2 == e2); // e2 must be in the set too.
1497
a.DoA(1);
1498
}
1499
1500
TEST(ExpectationSetTest, SizeWorks) {
1501
ExpectationSet es;
1502
EXPECT_EQ(0, es.size());
1503
1504
es += Expectation();
1505
EXPECT_EQ(1, es.size());
1506
1507
MockA a;
1508
es += EXPECT_CALL(a, DoA(1));
1509
EXPECT_EQ(2, es.size());
1510
1511
a.DoA(1);
1512
}
1513
1514
TEST(ExpectationSetTest, IsEnumerable) {
1515
ExpectationSet es;
1516
EXPECT_TRUE(es.begin() == es.end());
1517
1518
es += Expectation();
1519
ExpectationSet::const_iterator it = es.begin();
1520
EXPECT_TRUE(it != es.end());
1521
EXPECT_THAT(*it, Eq(Expectation()));
1522
++it;
1523
EXPECT_TRUE(it == es.end());
1524
}
1525
1526
// Tests the .After() clause.
1527
1528
TEST(AfterTest, SucceedsWhenPartialOrderIsSatisfied) {
1529
MockA a;
1530
ExpectationSet es;
1531
es += EXPECT_CALL(a, DoA(1));
1532
es += EXPECT_CALL(a, DoA(2));
1533
EXPECT_CALL(a, DoA(3)).After(es);
1534
1535
a.DoA(1);
1536
a.DoA(2);
1537
a.DoA(3);
1538
}
1539
1540
TEST(AfterTest, SucceedsWhenTotalOrderIsSatisfied) {
1541
MockA a;
1542
MockB b;
1543
// The following also verifies that const Expectation objects work
1544
// too. Do not remove the const modifiers.
1545
const Expectation e1 = EXPECT_CALL(a, DoA(1));
1546
const Expectation e2 = EXPECT_CALL(b, DoB()).Times(2).After(e1);
1547
EXPECT_CALL(a, DoA(2)).After(e2);
1548
1549
a.DoA(1);
1550
b.DoB();
1551
b.DoB();
1552
a.DoA(2);
1553
}
1554
1555
// Calls must be in strict order when specified so using .After().
1556
TEST(AfterTest, CallsMustBeInStrictOrderWhenSpecifiedSo1) {
1557
MockA a;
1558
MockB b;
1559
1560
// Define ordering:
1561
// a.DoA(1) ==> b.DoB() ==> a.DoA(2)
1562
Expectation e1 = EXPECT_CALL(a, DoA(1));
1563
Expectation e2 = EXPECT_CALL(b, DoB()).After(e1);
1564
EXPECT_CALL(a, DoA(2)).After(e2);
1565
1566
a.DoA(1);
1567
1568
// May only be called after DoB().
1569
EXPECT_NONFATAL_FAILURE(a.DoA(2), "Unexpected mock function call");
1570
1571
b.DoB();
1572
a.DoA(2);
1573
}
1574
1575
// Calls must be in strict order when specified so using .After().
1576
TEST(AfterTest, CallsMustBeInStrictOrderWhenSpecifiedSo2) {
1577
MockA a;
1578
MockB b;
1579
1580
// Define ordering:
1581
// a.DoA(1) ==> b.DoB() * 2 ==> a.DoA(2)
1582
Expectation e1 = EXPECT_CALL(a, DoA(1));
1583
Expectation e2 = EXPECT_CALL(b, DoB()).Times(2).After(e1);
1584
EXPECT_CALL(a, DoA(2)).After(e2);
1585
1586
a.DoA(1);
1587
b.DoB();
1588
1589
// May only be called after the second DoB().
1590
EXPECT_NONFATAL_FAILURE(a.DoA(2), "Unexpected mock function call");
1591
1592
b.DoB();
1593
a.DoA(2);
1594
}
1595
1596
// Calls must satisfy the partial order when specified so.
1597
TEST(AfterTest, CallsMustSatisfyPartialOrderWhenSpecifiedSo) {
1598
MockA a;
1599
ON_CALL(a, ReturnResult(_)).WillByDefault(Return(Result()));
1600
1601
// Define ordering:
1602
// a.DoA(1) ==>
1603
// a.DoA(2) ==> a.ReturnResult(3)
1604
Expectation e = EXPECT_CALL(a, DoA(1));
1605
const ExpectationSet es = EXPECT_CALL(a, DoA(2));
1606
EXPECT_CALL(a, ReturnResult(3)).After(e, es);
1607
1608
// May only be called last.
1609
EXPECT_NONFATAL_FAILURE(a.ReturnResult(3), "Unexpected mock function call");
1610
1611
a.DoA(2);
1612
a.DoA(1);
1613
a.ReturnResult(3);
1614
}
1615
1616
// Calls must satisfy the partial order when specified so.
1617
TEST(AfterTest, CallsMustSatisfyPartialOrderWhenSpecifiedSo2) {
1618
MockA a;
1619
1620
// Define ordering:
1621
// a.DoA(1) ==>
1622
// a.DoA(2) ==> a.DoA(3)
1623
Expectation e = EXPECT_CALL(a, DoA(1));
1624
const ExpectationSet es = EXPECT_CALL(a, DoA(2));
1625
EXPECT_CALL(a, DoA(3)).After(e, es);
1626
1627
a.DoA(2);
1628
1629
// May only be called last.
1630
EXPECT_NONFATAL_FAILURE(a.DoA(3), "Unexpected mock function call");
1631
1632
a.DoA(1);
1633
a.DoA(3);
1634
}
1635
1636
// .After() can be combined with .InSequence().
1637
TEST(AfterTest, CanBeUsedWithInSequence) {
1638
MockA a;
1639
Sequence s;
1640
Expectation e = EXPECT_CALL(a, DoA(1));
1641
EXPECT_CALL(a, DoA(2)).InSequence(s);
1642
EXPECT_CALL(a, DoA(3)).InSequence(s).After(e);
1643
1644
a.DoA(1);
1645
1646
// May only be after DoA(2).
1647
EXPECT_NONFATAL_FAILURE(a.DoA(3), "Unexpected mock function call");
1648
1649
a.DoA(2);
1650
a.DoA(3);
1651
}
1652
1653
// .After() can be called multiple times.
1654
TEST(AfterTest, CanBeCalledManyTimes) {
1655
MockA a;
1656
Expectation e1 = EXPECT_CALL(a, DoA(1));
1657
Expectation e2 = EXPECT_CALL(a, DoA(2));
1658
Expectation e3 = EXPECT_CALL(a, DoA(3));
1659
EXPECT_CALL(a, DoA(4)).After(e1).After(e2).After(e3);
1660
1661
a.DoA(3);
1662
a.DoA(1);
1663
a.DoA(2);
1664
a.DoA(4);
1665
}
1666
1667
// .After() accepts up to 5 arguments.
1668
TEST(AfterTest, AcceptsUpToFiveArguments) {
1669
MockA a;
1670
Expectation e1 = EXPECT_CALL(a, DoA(1));
1671
Expectation e2 = EXPECT_CALL(a, DoA(2));
1672
Expectation e3 = EXPECT_CALL(a, DoA(3));
1673
ExpectationSet es1 = EXPECT_CALL(a, DoA(4));
1674
ExpectationSet es2 = EXPECT_CALL(a, DoA(5));
1675
EXPECT_CALL(a, DoA(6)).After(e1, e2, e3, es1, es2);
1676
1677
a.DoA(5);
1678
a.DoA(2);
1679
a.DoA(4);
1680
a.DoA(1);
1681
a.DoA(3);
1682
a.DoA(6);
1683
}
1684
1685
// .After() allows input to contain duplicated Expectations.
1686
TEST(AfterTest, AcceptsDuplicatedInput) {
1687
MockA a;
1688
ON_CALL(a, ReturnResult(_)).WillByDefault(Return(Result()));
1689
1690
// Define ordering:
1691
// DoA(1) ==>
1692
// DoA(2) ==> ReturnResult(3)
1693
Expectation e1 = EXPECT_CALL(a, DoA(1));
1694
Expectation e2 = EXPECT_CALL(a, DoA(2));
1695
ExpectationSet es;
1696
es += e1;
1697
es += e2;
1698
EXPECT_CALL(a, ReturnResult(3)).After(e1, e2, es, e1);
1699
1700
a.DoA(1);
1701
1702
// May only be after DoA(2).
1703
EXPECT_NONFATAL_FAILURE(a.ReturnResult(3), "Unexpected mock function call");
1704
1705
a.DoA(2);
1706
a.ReturnResult(3);
1707
}
1708
1709
// An Expectation added to an ExpectationSet after it has been used in
1710
// an .After() has no effect.
1711
TEST(AfterTest, ChangesToExpectationSetHaveNoEffectAfterwards) {
1712
MockA a;
1713
ExpectationSet es1 = EXPECT_CALL(a, DoA(1));
1714
Expectation e2 = EXPECT_CALL(a, DoA(2));
1715
EXPECT_CALL(a, DoA(3)).After(es1);
1716
es1 += e2;
1717
1718
a.DoA(1);
1719
a.DoA(3);
1720
a.DoA(2);
1721
}
1722
1723
// Tests that Google Mock correctly handles calls to mock functions
1724
// after a mock object owning one of their pre-requisites has died.
1725
1726
// Tests that calls that satisfy the original spec are successful.
1727
TEST(DeletingMockEarlyTest, Success1) {
1728
MockB* const b1 = new MockB;
1729
MockA* const a = new MockA;
1730
MockB* const b2 = new MockB;
1731
1732
{
1733
InSequence dummy;
1734
EXPECT_CALL(*b1, DoB(_)).WillOnce(Return(1));
1735
EXPECT_CALL(*a, Binary(_, _))
1736
.Times(AnyNumber())
1737
.WillRepeatedly(Return(true));
1738
EXPECT_CALL(*b2, DoB(_)).Times(AnyNumber()).WillRepeatedly(Return(2));
1739
}
1740
1741
EXPECT_EQ(1, b1->DoB(1));
1742
delete b1;
1743
// a's pre-requisite has died.
1744
EXPECT_TRUE(a->Binary(0, 1));
1745
delete b2;
1746
// a's successor has died.
1747
EXPECT_TRUE(a->Binary(1, 2));
1748
delete a;
1749
}
1750
1751
// Tests that calls that satisfy the original spec are successful.
1752
TEST(DeletingMockEarlyTest, Success2) {
1753
MockB* const b1 = new MockB;
1754
MockA* const a = new MockA;
1755
MockB* const b2 = new MockB;
1756
1757
{
1758
InSequence dummy;
1759
EXPECT_CALL(*b1, DoB(_)).WillOnce(Return(1));
1760
EXPECT_CALL(*a, Binary(_, _)).Times(AnyNumber());
1761
EXPECT_CALL(*b2, DoB(_)).Times(AnyNumber()).WillRepeatedly(Return(2));
1762
}
1763
1764
delete a; // a is trivially satisfied.
1765
EXPECT_EQ(1, b1->DoB(1));
1766
EXPECT_EQ(2, b2->DoB(2));
1767
delete b1;
1768
delete b2;
1769
}
1770
1771
// Tests that it's OK to delete a mock object itself in its action.
1772
1773
// Suppresses warning on unreferenced formal parameter in MSVC with
1774
// -W4.
1775
GTEST_DISABLE_MSC_WARNINGS_PUSH_(4100)
1776
1777
ACTION_P(Delete, ptr) { delete ptr; }
1778
1779
GTEST_DISABLE_MSC_WARNINGS_POP_() // 4100
1780
1781
TEST(DeletingMockEarlyTest, CanDeleteSelfInActionReturningVoid) {
1782
MockA* const a = new MockA;
1783
EXPECT_CALL(*a, DoA(_)).WillOnce(Delete(a));
1784
a->DoA(42); // This will cause a to be deleted.
1785
}
1786
1787
TEST(DeletingMockEarlyTest, CanDeleteSelfInActionReturningValue) {
1788
MockA* const a = new MockA;
1789
EXPECT_CALL(*a, ReturnResult(_)).WillOnce(DoAll(Delete(a), Return(Result())));
1790
a->ReturnResult(42); // This will cause a to be deleted.
1791
}
1792
1793
// Tests that calls that violate the original spec yield failures.
1794
TEST(DeletingMockEarlyTest, Failure1) {
1795
MockB* const b1 = new MockB;
1796
MockA* const a = new MockA;
1797
MockB* const b2 = new MockB;
1798
1799
{
1800
InSequence dummy;
1801
EXPECT_CALL(*b1, DoB(_)).WillOnce(Return(1));
1802
EXPECT_CALL(*a, Binary(_, _)).Times(AnyNumber());
1803
EXPECT_CALL(*b2, DoB(_)).Times(AnyNumber()).WillRepeatedly(Return(2));
1804
}
1805
1806
delete a; // a is trivially satisfied.
1807
EXPECT_NONFATAL_FAILURE({ b2->DoB(2); }, "Unexpected mock function call");
1808
EXPECT_EQ(1, b1->DoB(1));
1809
delete b1;
1810
delete b2;
1811
}
1812
1813
// Tests that calls that violate the original spec yield failures.
1814
TEST(DeletingMockEarlyTest, Failure2) {
1815
MockB* const b1 = new MockB;
1816
MockA* const a = new MockA;
1817
MockB* const b2 = new MockB;
1818
1819
{
1820
InSequence dummy;
1821
EXPECT_CALL(*b1, DoB(_));
1822
EXPECT_CALL(*a, Binary(_, _)).Times(AnyNumber());
1823
EXPECT_CALL(*b2, DoB(_)).Times(AnyNumber());
1824
}
1825
1826
EXPECT_NONFATAL_FAILURE(delete b1, "Actual: never called");
1827
EXPECT_NONFATAL_FAILURE(a->Binary(0, 1), "Unexpected mock function call");
1828
EXPECT_NONFATAL_FAILURE(b2->DoB(1), "Unexpected mock function call");
1829
delete a;
1830
delete b2;
1831
}
1832
1833
class EvenNumberCardinality : public CardinalityInterface {
1834
public:
1835
// Returns true if and only if call_count calls will satisfy this
1836
// cardinality.
1837
bool IsSatisfiedByCallCount(int call_count) const override {
1838
return call_count % 2 == 0;
1839
}
1840
1841
// Returns true if and only if call_count calls will saturate this
1842
// cardinality.
1843
bool IsSaturatedByCallCount(int /* call_count */) const override {
1844
return false;
1845
}
1846
1847
// Describes self to an ostream.
1848
void DescribeTo(::std::ostream* os) const override {
1849
*os << "called even number of times";
1850
}
1851
};
1852
1853
Cardinality EvenNumber() { return Cardinality(new EvenNumberCardinality); }
1854
1855
TEST(ExpectationBaseTest,
1856
AllPrerequisitesAreSatisfiedWorksForNonMonotonicCardinality) {
1857
MockA* a = new MockA;
1858
Sequence s;
1859
1860
EXPECT_CALL(*a, DoA(1)).Times(EvenNumber()).InSequence(s);
1861
EXPECT_CALL(*a, DoA(2)).Times(AnyNumber()).InSequence(s);
1862
EXPECT_CALL(*a, DoA(3)).Times(AnyNumber());
1863
1864
a->DoA(3);
1865
a->DoA(1);
1866
EXPECT_NONFATAL_FAILURE(a->DoA(2), "Unexpected mock function call");
1867
EXPECT_NONFATAL_FAILURE(delete a, "to be called even number of times");
1868
}
1869
1870
// The following tests verify the message generated when a mock
1871
// function is called.
1872
1873
struct Printable {};
1874
1875
inline void operator<<(::std::ostream& os, const Printable&) {
1876
os << "Printable";
1877
}
1878
1879
struct Unprintable {
1880
Unprintable() : value(0) {}
1881
int value;
1882
};
1883
1884
class MockC {
1885
public:
1886
MockC() = default;
1887
1888
MOCK_METHOD6(VoidMethod, void(bool cond, int n, std::string s, void* p,
1889
const Printable& x, Unprintable y));
1890
MOCK_METHOD0(NonVoidMethod, int()); // NOLINT
1891
1892
private:
1893
MockC(const MockC&) = delete;
1894
MockC& operator=(const MockC&) = delete;
1895
};
1896
1897
class VerboseFlagPreservingFixture : public testing::Test {
1898
protected:
1899
VerboseFlagPreservingFixture()
1900
: saved_verbose_flag_(GMOCK_FLAG_GET(verbose)) {}
1901
1902
~VerboseFlagPreservingFixture() override {
1903
GMOCK_FLAG_SET(verbose, saved_verbose_flag_);
1904
}
1905
1906
private:
1907
const std::string saved_verbose_flag_;
1908
1909
VerboseFlagPreservingFixture(const VerboseFlagPreservingFixture&) = delete;
1910
VerboseFlagPreservingFixture& operator=(const VerboseFlagPreservingFixture&) =
1911
delete;
1912
};
1913
1914
#if GTEST_HAS_STREAM_REDIRECTION
1915
1916
// Tests that an uninteresting mock function call on a naggy mock
1917
// generates a warning without the stack trace when
1918
// --gmock_verbose=warning is specified.
1919
TEST(FunctionCallMessageTest,
1920
UninterestingCallOnNaggyMockGeneratesNoStackTraceWhenVerboseWarning) {
1921
GMOCK_FLAG_SET(verbose, kWarningVerbosity);
1922
NaggyMock<MockC> c;
1923
CaptureStdout();
1924
c.VoidMethod(false, 5, "Hi", nullptr, Printable(), Unprintable());
1925
const std::string output = GetCapturedStdout();
1926
EXPECT_PRED_FORMAT2(IsSubstring, "GMOCK WARNING", output);
1927
EXPECT_PRED_FORMAT2(IsNotSubstring, "Stack trace:", output);
1928
}
1929
1930
// Tests that an uninteresting mock function call on a naggy mock
1931
// generates a warning containing the stack trace when
1932
// --gmock_verbose=info is specified.
1933
TEST(FunctionCallMessageTest,
1934
UninterestingCallOnNaggyMockGeneratesFyiWithStackTraceWhenVerboseInfo) {
1935
GMOCK_FLAG_SET(verbose, kInfoVerbosity);
1936
NaggyMock<MockC> c;
1937
CaptureStdout();
1938
c.VoidMethod(false, 5, "Hi", nullptr, Printable(), Unprintable());
1939
const std::string output = GetCapturedStdout();
1940
EXPECT_PRED_FORMAT2(IsSubstring, "GMOCK WARNING", output);
1941
EXPECT_PRED_FORMAT2(IsSubstring, "Stack trace:", output);
1942
1943
#ifndef NDEBUG
1944
1945
// We check the stack trace content in dbg-mode only, as opt-mode
1946
// may inline the call we are interested in seeing.
1947
1948
// Verifies that a void mock function's name appears in the stack
1949
// trace.
1950
EXPECT_PRED_FORMAT2(IsSubstring, "VoidMethod(", output);
1951
1952
// Verifies that a non-void mock function's name appears in the
1953
// stack trace.
1954
CaptureStdout();
1955
c.NonVoidMethod();
1956
const std::string output2 = GetCapturedStdout();
1957
EXPECT_PRED_FORMAT2(IsSubstring, "NonVoidMethod(", output2);
1958
1959
#endif // NDEBUG
1960
}
1961
1962
// Tests that an uninteresting mock function call on a naggy mock
1963
// causes the function arguments and return value to be printed.
1964
TEST(FunctionCallMessageTest,
1965
UninterestingCallOnNaggyMockPrintsArgumentsAndReturnValue) {
1966
// A non-void mock function.
1967
NaggyMock<MockB> b;
1968
CaptureStdout();
1969
b.DoB();
1970
const std::string output1 = GetCapturedStdout();
1971
EXPECT_PRED_FORMAT2(
1972
IsSubstring,
1973
"Uninteresting mock function call - returning default value.\n"
1974
" Function call: DoB()\n"
1975
" Returns: 0\n",
1976
output1.c_str());
1977
// Makes sure the return value is printed.
1978
1979
// A void mock function.
1980
NaggyMock<MockC> c;
1981
CaptureStdout();
1982
c.VoidMethod(false, 5, "Hi", nullptr, Printable(), Unprintable());
1983
const std::string output2 = GetCapturedStdout();
1984
EXPECT_THAT(
1985
output2.c_str(),
1986
ContainsRegex("Uninteresting mock function call - returning directly\\.\n"
1987
" Function call: VoidMethod"
1988
"\\(false, 5, \"Hi\", NULL, @.+ "
1989
"Printable, 4-byte object <00-00 00-00>\\)"));
1990
// A void function has no return value to print.
1991
}
1992
1993
// Tests how the --gmock_verbose flag affects Google Mock's output.
1994
1995
class GMockVerboseFlagTest : public VerboseFlagPreservingFixture {
1996
public:
1997
// Verifies that the given Google Mock output is correct. (When
1998
// should_print is true, the output should match the given regex and
1999
// contain the given function name in the stack trace. When it's
2000
// false, the output should be empty.)
2001
void VerifyOutput(const std::string& output, bool should_print,
2002
const std::string& expected_substring,
2003
const std::string& function_name) {
2004
if (should_print) {
2005
EXPECT_THAT(output.c_str(), HasSubstr(expected_substring));
2006
#ifndef NDEBUG
2007
// We check the stack trace content in dbg-mode only, as opt-mode
2008
// may inline the call we are interested in seeing.
2009
EXPECT_THAT(output.c_str(), HasSubstr(function_name));
2010
#else
2011
// Suppresses 'unused function parameter' warnings.
2012
static_cast<void>(function_name);
2013
#endif // NDEBUG
2014
} else {
2015
EXPECT_STREQ("", output.c_str());
2016
}
2017
}
2018
2019
// Tests how the flag affects expected calls.
2020
void TestExpectedCall(bool should_print) {
2021
MockA a;
2022
EXPECT_CALL(a, DoA(5));
2023
EXPECT_CALL(a, Binary(_, 1)).WillOnce(Return(true));
2024
2025
// A void-returning function.
2026
CaptureStdout();
2027
a.DoA(5);
2028
VerifyOutput(GetCapturedStdout(), should_print,
2029
"Mock function call matches EXPECT_CALL(a, DoA(5))...\n"
2030
" Function call: DoA(5)\n"
2031
"Stack trace:\n",
2032
"DoA");
2033
2034
// A non-void-returning function.
2035
CaptureStdout();
2036
a.Binary(2, 1);
2037
VerifyOutput(GetCapturedStdout(), should_print,
2038
"Mock function call matches EXPECT_CALL(a, Binary(_, 1))...\n"
2039
" Function call: Binary(2, 1)\n"
2040
" Returns: true\n"
2041
"Stack trace:\n",
2042
"Binary");
2043
}
2044
2045
// Tests how the flag affects uninteresting calls on a naggy mock.
2046
void TestUninterestingCallOnNaggyMock(bool should_print) {
2047
NaggyMock<MockA> a;
2048
const std::string note =
2049
"NOTE: You can safely ignore the above warning unless this "
2050
"call should not happen. Do not suppress it by blindly adding "
2051
"an EXPECT_CALL() if you don't mean to enforce the call. "
2052
"See "
2053
"https://github.com/google/googletest/blob/main/docs/"
2054
"gmock_cook_book.md#"
2055
"knowing-when-to-expect-useoncall for details.";
2056
2057
// A void-returning function.
2058
CaptureStdout();
2059
a.DoA(5);
2060
VerifyOutput(GetCapturedStdout(), should_print,
2061
"\nGMOCK WARNING:\n"
2062
"Uninteresting mock function call - returning directly.\n"
2063
" Function call: DoA(5)\n" +
2064
note,
2065
"DoA");
2066
2067
// A non-void-returning function.
2068
CaptureStdout();
2069
a.Binary(2, 1);
2070
VerifyOutput(GetCapturedStdout(), should_print,
2071
"\nGMOCK WARNING:\n"
2072
"Uninteresting mock function call - returning default value.\n"
2073
" Function call: Binary(2, 1)\n"
2074
" Returns: false\n" +
2075
note,
2076
"Binary");
2077
}
2078
};
2079
2080
// Tests that --gmock_verbose=info causes both expected and
2081
// uninteresting calls to be reported.
2082
TEST_F(GMockVerboseFlagTest, Info) {
2083
GMOCK_FLAG_SET(verbose, kInfoVerbosity);
2084
TestExpectedCall(true);
2085
TestUninterestingCallOnNaggyMock(true);
2086
}
2087
2088
// Tests that --gmock_verbose=warning causes uninteresting calls to be
2089
// reported.
2090
TEST_F(GMockVerboseFlagTest, Warning) {
2091
GMOCK_FLAG_SET(verbose, kWarningVerbosity);
2092
TestExpectedCall(false);
2093
TestUninterestingCallOnNaggyMock(true);
2094
}
2095
2096
// Tests that --gmock_verbose=warning causes neither expected nor
2097
// uninteresting calls to be reported.
2098
TEST_F(GMockVerboseFlagTest, Error) {
2099
GMOCK_FLAG_SET(verbose, kErrorVerbosity);
2100
TestExpectedCall(false);
2101
TestUninterestingCallOnNaggyMock(false);
2102
}
2103
2104
// Tests that --gmock_verbose=SOME_INVALID_VALUE has the same effect
2105
// as --gmock_verbose=warning.
2106
TEST_F(GMockVerboseFlagTest, InvalidFlagIsTreatedAsWarning) {
2107
GMOCK_FLAG_SET(verbose, "invalid"); // Treated as "warning".
2108
TestExpectedCall(false);
2109
TestUninterestingCallOnNaggyMock(true);
2110
}
2111
2112
#endif // GTEST_HAS_STREAM_REDIRECTION
2113
2114
// A helper class that generates a failure when printed. We use it to
2115
// ensure that Google Mock doesn't print a value (even to an internal
2116
// buffer) when it is not supposed to do so.
2117
class PrintMeNot {};
2118
2119
void PrintTo(PrintMeNot /* dummy */, ::std::ostream* /* os */) {
2120
ADD_FAILURE() << "Google Mock is printing a value that shouldn't be "
2121
<< "printed even to an internal buffer.";
2122
}
2123
2124
class LogTestHelper {
2125
public:
2126
LogTestHelper() = default;
2127
2128
MOCK_METHOD1(Foo, PrintMeNot(PrintMeNot));
2129
2130
private:
2131
LogTestHelper(const LogTestHelper&) = delete;
2132
LogTestHelper& operator=(const LogTestHelper&) = delete;
2133
};
2134
2135
class GMockLogTest : public VerboseFlagPreservingFixture {
2136
protected:
2137
LogTestHelper helper_;
2138
};
2139
2140
TEST_F(GMockLogTest, DoesNotPrintGoodCallInternallyIfVerbosityIsWarning) {
2141
GMOCK_FLAG_SET(verbose, kWarningVerbosity);
2142
EXPECT_CALL(helper_, Foo(_)).WillOnce(Return(PrintMeNot()));
2143
helper_.Foo(PrintMeNot()); // This is an expected call.
2144
}
2145
2146
TEST_F(GMockLogTest, DoesNotPrintGoodCallInternallyIfVerbosityIsError) {
2147
GMOCK_FLAG_SET(verbose, kErrorVerbosity);
2148
EXPECT_CALL(helper_, Foo(_)).WillOnce(Return(PrintMeNot()));
2149
helper_.Foo(PrintMeNot()); // This is an expected call.
2150
}
2151
2152
TEST_F(GMockLogTest, DoesNotPrintWarningInternallyIfVerbosityIsError) {
2153
GMOCK_FLAG_SET(verbose, kErrorVerbosity);
2154
ON_CALL(helper_, Foo(_)).WillByDefault(Return(PrintMeNot()));
2155
helper_.Foo(PrintMeNot()); // This should generate a warning.
2156
}
2157
2158
// Tests Mock::AllowLeak().
2159
2160
TEST(AllowLeakTest, AllowsLeakingUnusedMockObject) {
2161
MockA* a = new MockA;
2162
Mock::AllowLeak(a);
2163
}
2164
2165
TEST(AllowLeakTest, CanBeCalledBeforeOnCall) {
2166
MockA* a = new MockA;
2167
Mock::AllowLeak(a);
2168
ON_CALL(*a, DoA(_)).WillByDefault(Return());
2169
a->DoA(0);
2170
}
2171
2172
TEST(AllowLeakTest, CanBeCalledAfterOnCall) {
2173
MockA* a = new MockA;
2174
ON_CALL(*a, DoA(_)).WillByDefault(Return());
2175
Mock::AllowLeak(a);
2176
}
2177
2178
TEST(AllowLeakTest, CanBeCalledBeforeExpectCall) {
2179
MockA* a = new MockA;
2180
Mock::AllowLeak(a);
2181
EXPECT_CALL(*a, DoA(_));
2182
a->DoA(0);
2183
}
2184
2185
TEST(AllowLeakTest, CanBeCalledAfterExpectCall) {
2186
MockA* a = new MockA;
2187
EXPECT_CALL(*a, DoA(_)).Times(AnyNumber());
2188
Mock::AllowLeak(a);
2189
}
2190
2191
TEST(AllowLeakTest, WorksWhenBothOnCallAndExpectCallArePresent) {
2192
MockA* a = new MockA;
2193
ON_CALL(*a, DoA(_)).WillByDefault(Return());
2194
EXPECT_CALL(*a, DoA(_)).Times(AnyNumber());
2195
Mock::AllowLeak(a);
2196
}
2197
2198
// Tests that we can verify and clear a mock object's expectations
2199
// when none of its methods has expectations.
2200
TEST(VerifyAndClearExpectationsTest, NoMethodHasExpectations) {
2201
MockB b;
2202
ASSERT_TRUE(Mock::VerifyAndClearExpectations(&b));
2203
2204
// There should be no expectations on the methods now, so we can
2205
// freely call them.
2206
EXPECT_EQ(0, b.DoB());
2207
EXPECT_EQ(0, b.DoB(1));
2208
}
2209
2210
// Tests that we can verify and clear a mock object's expectations
2211
// when some, but not all, of its methods have expectations *and* the
2212
// verification succeeds.
2213
TEST(VerifyAndClearExpectationsTest, SomeMethodsHaveExpectationsAndSucceed) {
2214
MockB b;
2215
EXPECT_CALL(b, DoB()).WillOnce(Return(1));
2216
b.DoB();
2217
ASSERT_TRUE(Mock::VerifyAndClearExpectations(&b));
2218
2219
// There should be no expectations on the methods now, so we can
2220
// freely call them.
2221
EXPECT_EQ(0, b.DoB());
2222
EXPECT_EQ(0, b.DoB(1));
2223
}
2224
2225
// Tests that we can verify and clear a mock object's expectations
2226
// when some, but not all, of its methods have expectations *and* the
2227
// verification fails.
2228
TEST(VerifyAndClearExpectationsTest, SomeMethodsHaveExpectationsAndFail) {
2229
MockB b;
2230
EXPECT_CALL(b, DoB()).WillOnce(Return(1));
2231
bool result = true;
2232
EXPECT_NONFATAL_FAILURE(result = Mock::VerifyAndClearExpectations(&b),
2233
"Actual: never called");
2234
ASSERT_FALSE(result);
2235
2236
// There should be no expectations on the methods now, so we can
2237
// freely call them.
2238
EXPECT_EQ(0, b.DoB());
2239
EXPECT_EQ(0, b.DoB(1));
2240
}
2241
2242
// Tests that we can verify and clear a mock object's expectations
2243
// when all of its methods have expectations.
2244
TEST(VerifyAndClearExpectationsTest, AllMethodsHaveExpectations) {
2245
MockB b;
2246
EXPECT_CALL(b, DoB()).WillOnce(Return(1));
2247
EXPECT_CALL(b, DoB(_)).WillOnce(Return(2));
2248
b.DoB();
2249
b.DoB(1);
2250
ASSERT_TRUE(Mock::VerifyAndClearExpectations(&b));
2251
2252
// There should be no expectations on the methods now, so we can
2253
// freely call them.
2254
EXPECT_EQ(0, b.DoB());
2255
EXPECT_EQ(0, b.DoB(1));
2256
}
2257
2258
// Tests that we can verify and clear a mock object's expectations
2259
// when a method has more than one expectation.
2260
TEST(VerifyAndClearExpectationsTest, AMethodHasManyExpectations) {
2261
MockB b;
2262
EXPECT_CALL(b, DoB(0)).WillOnce(Return(1));
2263
EXPECT_CALL(b, DoB(_)).WillOnce(Return(2));
2264
b.DoB(1);
2265
bool result = true;
2266
EXPECT_NONFATAL_FAILURE(result = Mock::VerifyAndClearExpectations(&b),
2267
"Actual: never called");
2268
ASSERT_FALSE(result);
2269
2270
// There should be no expectations on the methods now, so we can
2271
// freely call them.
2272
EXPECT_EQ(0, b.DoB());
2273
EXPECT_EQ(0, b.DoB(1));
2274
}
2275
2276
// Tests that we can call VerifyAndClearExpectations() on the same
2277
// mock object multiple times.
2278
TEST(VerifyAndClearExpectationsTest, CanCallManyTimes) {
2279
MockB b;
2280
EXPECT_CALL(b, DoB());
2281
b.DoB();
2282
Mock::VerifyAndClearExpectations(&b);
2283
2284
EXPECT_CALL(b, DoB(_)).WillOnce(Return(1));
2285
b.DoB(1);
2286
Mock::VerifyAndClearExpectations(&b);
2287
Mock::VerifyAndClearExpectations(&b);
2288
2289
// There should be no expectations on the methods now, so we can
2290
// freely call them.
2291
EXPECT_EQ(0, b.DoB());
2292
EXPECT_EQ(0, b.DoB(1));
2293
}
2294
2295
// Tests that we can clear a mock object's default actions when none
2296
// of its methods has default actions.
2297
TEST(VerifyAndClearTest, NoMethodHasDefaultActions) {
2298
MockB b;
2299
// If this crashes or generates a failure, the test will catch it.
2300
Mock::VerifyAndClear(&b);
2301
EXPECT_EQ(0, b.DoB());
2302
}
2303
2304
// Tests that we can clear a mock object's default actions when some,
2305
// but not all of its methods have default actions.
2306
TEST(VerifyAndClearTest, SomeMethodsHaveDefaultActions) {
2307
MockB b;
2308
ON_CALL(b, DoB()).WillByDefault(Return(1));
2309
2310
Mock::VerifyAndClear(&b);
2311
2312
// Verifies that the default action of int DoB() was removed.
2313
EXPECT_EQ(0, b.DoB());
2314
}
2315
2316
// Tests that we can clear a mock object's default actions when all of
2317
// its methods have default actions.
2318
TEST(VerifyAndClearTest, AllMethodsHaveDefaultActions) {
2319
MockB b;
2320
ON_CALL(b, DoB()).WillByDefault(Return(1));
2321
ON_CALL(b, DoB(_)).WillByDefault(Return(2));
2322
2323
Mock::VerifyAndClear(&b);
2324
2325
// Verifies that the default action of int DoB() was removed.
2326
EXPECT_EQ(0, b.DoB());
2327
2328
// Verifies that the default action of int DoB(int) was removed.
2329
EXPECT_EQ(0, b.DoB(0));
2330
}
2331
2332
// Tests that we can clear a mock object's default actions when a
2333
// method has more than one ON_CALL() set on it.
2334
TEST(VerifyAndClearTest, AMethodHasManyDefaultActions) {
2335
MockB b;
2336
ON_CALL(b, DoB(0)).WillByDefault(Return(1));
2337
ON_CALL(b, DoB(_)).WillByDefault(Return(2));
2338
2339
Mock::VerifyAndClear(&b);
2340
2341
// Verifies that the default actions (there are two) of int DoB(int)
2342
// were removed.
2343
EXPECT_EQ(0, b.DoB(0));
2344
EXPECT_EQ(0, b.DoB(1));
2345
}
2346
2347
// Tests that we can call VerifyAndClear() on a mock object multiple
2348
// times.
2349
TEST(VerifyAndClearTest, CanCallManyTimes) {
2350
MockB b;
2351
ON_CALL(b, DoB()).WillByDefault(Return(1));
2352
Mock::VerifyAndClear(&b);
2353
Mock::VerifyAndClear(&b);
2354
2355
ON_CALL(b, DoB(_)).WillByDefault(Return(1));
2356
Mock::VerifyAndClear(&b);
2357
2358
EXPECT_EQ(0, b.DoB());
2359
EXPECT_EQ(0, b.DoB(1));
2360
}
2361
2362
// Tests that VerifyAndClear() works when the verification succeeds.
2363
TEST(VerifyAndClearTest, Success) {
2364
MockB b;
2365
ON_CALL(b, DoB()).WillByDefault(Return(1));
2366
EXPECT_CALL(b, DoB(1)).WillOnce(Return(2));
2367
2368
b.DoB();
2369
b.DoB(1);
2370
ASSERT_TRUE(Mock::VerifyAndClear(&b));
2371
2372
// There should be no expectations on the methods now, so we can
2373
// freely call them.
2374
EXPECT_EQ(0, b.DoB());
2375
EXPECT_EQ(0, b.DoB(1));
2376
}
2377
2378
// Tests that VerifyAndClear() works when the verification fails.
2379
TEST(VerifyAndClearTest, Failure) {
2380
MockB b;
2381
ON_CALL(b, DoB(_)).WillByDefault(Return(1));
2382
EXPECT_CALL(b, DoB()).WillOnce(Return(2));
2383
2384
b.DoB(1);
2385
bool result = true;
2386
EXPECT_NONFATAL_FAILURE(result = Mock::VerifyAndClear(&b),
2387
"Actual: never called");
2388
ASSERT_FALSE(result);
2389
2390
// There should be no expectations on the methods now, so we can
2391
// freely call them.
2392
EXPECT_EQ(0, b.DoB());
2393
EXPECT_EQ(0, b.DoB(1));
2394
}
2395
2396
// Tests that VerifyAndClear() works when the default actions and
2397
// expectations are set on a const mock object.
2398
TEST(VerifyAndClearTest, Const) {
2399
MockB b;
2400
ON_CALL(Const(b), DoB()).WillByDefault(Return(1));
2401
2402
EXPECT_CALL(Const(b), DoB()).WillOnce(DoDefault()).WillOnce(Return(2));
2403
2404
b.DoB();
2405
b.DoB();
2406
ASSERT_TRUE(Mock::VerifyAndClear(&b));
2407
2408
// There should be no expectations on the methods now, so we can
2409
// freely call them.
2410
EXPECT_EQ(0, b.DoB());
2411
EXPECT_EQ(0, b.DoB(1));
2412
}
2413
2414
// Tests that we can set default actions and expectations on a mock
2415
// object after VerifyAndClear() has been called on it.
2416
TEST(VerifyAndClearTest, CanSetDefaultActionsAndExpectationsAfterwards) {
2417
MockB b;
2418
ON_CALL(b, DoB()).WillByDefault(Return(1));
2419
EXPECT_CALL(b, DoB(_)).WillOnce(Return(2));
2420
b.DoB(1);
2421
2422
Mock::VerifyAndClear(&b);
2423
2424
EXPECT_CALL(b, DoB()).WillOnce(Return(3));
2425
ON_CALL(b, DoB(_)).WillByDefault(Return(4));
2426
2427
EXPECT_EQ(3, b.DoB());
2428
EXPECT_EQ(4, b.DoB(1));
2429
}
2430
2431
// Tests that calling VerifyAndClear() on one mock object does not
2432
// affect other mock objects (either of the same type or not).
2433
TEST(VerifyAndClearTest, DoesNotAffectOtherMockObjects) {
2434
MockA a;
2435
MockB b1;
2436
MockB b2;
2437
2438
ON_CALL(a, Binary(_, _)).WillByDefault(Return(true));
2439
EXPECT_CALL(a, Binary(_, _)).WillOnce(DoDefault()).WillOnce(Return(false));
2440
2441
ON_CALL(b1, DoB()).WillByDefault(Return(1));
2442
EXPECT_CALL(b1, DoB(_)).WillOnce(Return(2));
2443
2444
ON_CALL(b2, DoB()).WillByDefault(Return(3));
2445
EXPECT_CALL(b2, DoB(_));
2446
2447
b2.DoB(0);
2448
Mock::VerifyAndClear(&b2);
2449
2450
// Verifies that the default actions and expectations of a and b1
2451
// are still in effect.
2452
EXPECT_TRUE(a.Binary(0, 0));
2453
EXPECT_FALSE(a.Binary(0, 0));
2454
2455
EXPECT_EQ(1, b1.DoB());
2456
EXPECT_EQ(2, b1.DoB(0));
2457
}
2458
2459
TEST(VerifyAndClearTest,
2460
DestroyingChainedMocksDoesNotDeadlockThroughExpectations) {
2461
std::shared_ptr<MockA> a(new MockA);
2462
ReferenceHoldingMock test_mock;
2463
2464
// EXPECT_CALL stores a reference to a inside test_mock.
2465
EXPECT_CALL(test_mock, AcceptReference(_))
2466
.WillRepeatedly(SetArgPointee<0>(a));
2467
2468
// Throw away the reference to the mock that we have in a. After this, the
2469
// only reference to it is stored by test_mock.
2470
a.reset();
2471
2472
// When test_mock goes out of scope, it destroys the last remaining reference
2473
// to the mock object originally pointed to by a. This will cause the MockA
2474
// destructor to be called from inside the ReferenceHoldingMock destructor.
2475
// The state of all mocks is protected by a single global lock, but there
2476
// should be no deadlock.
2477
}
2478
2479
TEST(VerifyAndClearTest,
2480
DestroyingChainedMocksDoesNotDeadlockThroughDefaultAction) {
2481
std::shared_ptr<MockA> a(new MockA);
2482
ReferenceHoldingMock test_mock;
2483
2484
// ON_CALL stores a reference to a inside test_mock.
2485
ON_CALL(test_mock, AcceptReference(_)).WillByDefault(SetArgPointee<0>(a));
2486
2487
// Throw away the reference to the mock that we have in a. After this, the
2488
// only reference to it is stored by test_mock.
2489
a.reset();
2490
2491
// When test_mock goes out of scope, it destroys the last remaining reference
2492
// to the mock object originally pointed to by a. This will cause the MockA
2493
// destructor to be called from inside the ReferenceHoldingMock destructor.
2494
// The state of all mocks is protected by a single global lock, but there
2495
// should be no deadlock.
2496
}
2497
2498
// Tests that a mock function's action can call a mock function
2499
// (either the same function or a different one) either as an explicit
2500
// action or as a default action without causing a dead lock. It
2501
// verifies that the action is not performed inside the critical
2502
// section.
2503
TEST(SynchronizationTest, CanCallMockMethodInAction) {
2504
MockA a;
2505
MockC c;
2506
ON_CALL(a, DoA(_)).WillByDefault(
2507
IgnoreResult(InvokeWithoutArgs(&c, &MockC::NonVoidMethod)));
2508
EXPECT_CALL(a, DoA(1));
2509
EXPECT_CALL(a, DoA(1))
2510
.WillOnce(Invoke(&a, &MockA::DoA))
2511
.RetiresOnSaturation();
2512
EXPECT_CALL(c, NonVoidMethod());
2513
2514
a.DoA(1);
2515
// This will match the second EXPECT_CALL() and trigger another a.DoA(1),
2516
// which will in turn match the first EXPECT_CALL() and trigger a call to
2517
// c.NonVoidMethod() that was specified by the ON_CALL() since the first
2518
// EXPECT_CALL() did not specify an action.
2519
}
2520
2521
TEST(ParameterlessExpectationsTest, CanSetExpectationsWithoutMatchers) {
2522
MockA a;
2523
int do_a_arg0 = 0;
2524
ON_CALL(a, DoA).WillByDefault(SaveArg<0>(&do_a_arg0));
2525
int do_a_47_arg0 = 0;
2526
ON_CALL(a, DoA(47)).WillByDefault(SaveArg<0>(&do_a_47_arg0));
2527
2528
a.DoA(17);
2529
EXPECT_THAT(do_a_arg0, 17);
2530
EXPECT_THAT(do_a_47_arg0, 0);
2531
a.DoA(47);
2532
EXPECT_THAT(do_a_arg0, 17);
2533
EXPECT_THAT(do_a_47_arg0, 47);
2534
2535
ON_CALL(a, Binary).WillByDefault(Return(true));
2536
ON_CALL(a, Binary(_, 14)).WillByDefault(Return(false));
2537
EXPECT_THAT(a.Binary(14, 17), true);
2538
EXPECT_THAT(a.Binary(17, 14), false);
2539
}
2540
2541
TEST(ParameterlessExpectationsTest, CanSetExpectationsForOverloadedMethods) {
2542
MockB b;
2543
ON_CALL(b, DoB()).WillByDefault(Return(9));
2544
ON_CALL(b, DoB(5)).WillByDefault(Return(11));
2545
2546
EXPECT_THAT(b.DoB(), 9);
2547
EXPECT_THAT(b.DoB(1), 0); // default value
2548
EXPECT_THAT(b.DoB(5), 11);
2549
}
2550
2551
struct MockWithConstMethods {
2552
public:
2553
MOCK_CONST_METHOD1(Foo, int(int));
2554
MOCK_CONST_METHOD2(Bar, int(int, const char*));
2555
};
2556
2557
TEST(ParameterlessExpectationsTest, CanSetExpectationsForConstMethods) {
2558
MockWithConstMethods mock;
2559
ON_CALL(mock, Foo).WillByDefault(Return(7));
2560
ON_CALL(mock, Bar).WillByDefault(Return(33));
2561
2562
EXPECT_THAT(mock.Foo(17), 7);
2563
EXPECT_THAT(mock.Bar(27, "purple"), 33);
2564
}
2565
2566
class MockConstOverload {
2567
public:
2568
MOCK_METHOD1(Overloaded, int(int));
2569
MOCK_CONST_METHOD1(Overloaded, int(int));
2570
};
2571
2572
TEST(ParameterlessExpectationsTest,
2573
CanSetExpectationsForConstOverloadedMethods) {
2574
MockConstOverload mock;
2575
ON_CALL(mock, Overloaded(_)).WillByDefault(Return(7));
2576
ON_CALL(mock, Overloaded(5)).WillByDefault(Return(9));
2577
ON_CALL(Const(mock), Overloaded(5)).WillByDefault(Return(11));
2578
ON_CALL(Const(mock), Overloaded(7)).WillByDefault(Return(13));
2579
2580
EXPECT_THAT(mock.Overloaded(1), 7);
2581
EXPECT_THAT(mock.Overloaded(5), 9);
2582
EXPECT_THAT(mock.Overloaded(7), 7);
2583
2584
const MockConstOverload& const_mock = mock;
2585
EXPECT_THAT(const_mock.Overloaded(1), 0);
2586
EXPECT_THAT(const_mock.Overloaded(5), 11);
2587
EXPECT_THAT(const_mock.Overloaded(7), 13);
2588
}
2589
2590
} // namespace
2591
} // namespace testing
2592
2593
int main(int argc, char** argv) {
2594
testing::InitGoogleMock(&argc, argv);
2595
// Ensures that the tests pass no matter what value of
2596
// --gmock_catch_leaked_mocks and --gmock_verbose the user specifies.
2597
GMOCK_FLAG_SET(catch_leaked_mocks, true);
2598
GMOCK_FLAG_SET(verbose, testing::internal::kWarningVerbosity);
2599
2600
return RUN_ALL_TESTS();
2601
}
2602
2603