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