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