2019-07-16 20:38:15 +02:00
|
|
|
# Googletest Mocking (gMock) Framework
|
2010-04-14 18:26:57 +02:00
|
|
|
|
2019-07-16 20:38:15 +02:00
|
|
|
### Overview
|
2008-12-10 06:08:54 +01:00
|
|
|
|
2019-07-16 20:38:15 +02:00
|
|
|
Google's framework for writing and using C++ mock classes. It can help you
|
|
|
|
derive better designs of your system and write better tests.
|
2015-08-30 18:36:37 +02:00
|
|
|
|
|
|
|
It is inspired by:
|
|
|
|
|
2020-05-05 23:07:05 +02:00
|
|
|
* [jMock](http://www.jmock.org/)
|
|
|
|
* [EasyMock](http://www.easymock.org/)
|
2020-05-01 08:54:32 +02:00
|
|
|
* [Hamcrest](http://code.google.com/p/hamcrest/)
|
2015-08-30 18:36:37 +02:00
|
|
|
|
2020-05-05 23:07:05 +02:00
|
|
|
It is designed with C++'s specifics in mind.
|
2015-08-30 18:36:37 +02:00
|
|
|
|
2019-07-16 20:38:15 +02:00
|
|
|
gMock:
|
|
|
|
|
2020-05-05 23:07:05 +02:00
|
|
|
- Provides a declarative syntax for defining mocks.
|
|
|
|
- Can define partial (hybrid) mocks, which are a cross of real and mock
|
|
|
|
objects.
|
|
|
|
- Handles functions of arbitrary types and overloaded functions.
|
|
|
|
- Comes with a rich set of matchers for validating function arguments.
|
|
|
|
- Uses an intuitive syntax for controlling the behavior of a mock.
|
|
|
|
- Does automatic verification of expectations (no record-and-replay needed).
|
|
|
|
- Allows arbitrary (partial) ordering constraints on function calls to be
|
|
|
|
expressed.
|
|
|
|
- Lets a user extend it by defining new matchers and actions.
|
|
|
|
- Does not use exceptions.
|
|
|
|
- Is easy to learn and use.
|
2019-07-16 20:38:15 +02:00
|
|
|
|
2019-07-30 09:17:22 +02:00
|
|
|
Details and examples can be found here:
|
|
|
|
|
2019-07-31 09:34:36 +02:00
|
|
|
* [gMock for Dummies](docs/for_dummies.md)
|
|
|
|
* [Legacy gMock FAQ](docs/gmock_faq.md)
|
|
|
|
* [gMock Cookbook](docs/cook_book.md)
|
|
|
|
* [gMock Cheat Sheet](docs/cheat_sheet.md)
|
2019-07-30 09:17:22 +02:00
|
|
|
|
2020-11-03 04:26:39 +01:00
|
|
|
Please note that code under scripts/generator/ is from the
|
|
|
|
[cppclean project](http://code.google.com/p/cppclean/) and under the Apache
|
2020-09-15 18:33:41 +02:00
|
|
|
License, which is different from GoogleMock's license.
|
2019-07-16 20:38:15 +02:00
|
|
|
|
2020-09-15 18:33:41 +02:00
|
|
|
GoogleMock is a part of
|
|
|
|
[GoogleTest C++ testing framework](http://github.com/google/googletest/) and a
|
2019-07-16 20:38:15 +02:00
|
|
|
subject to the same requirements.
|