Cotest

Cotest is an extension of Google Test with fully integrated support for coroutines:

• as contexts within which to run checking code and actions,
• and to execute the code under test.

Cotest allows for a linear test case layout, in which the test coroutine launches the code under test, and then accepts and returns mock calls in a single sequence of C++ statements. Cotest can do this without needing a data structure populated with expected future events. The user directly implements the test coroutine and can insert arbitrary logic to decide how to respond to mock calls and results from code under test, without needing to split the code into multiple lambda actions.

Cotest supports matching on both watches (similar to GMock expectations) and inside the coroutine body (a test coroutine can drop a mock call and GMock's matching search will continue). Cotest actions are coded directly into the coroutine body by the user. Cardinality is inferred from the execution state of the coroutine.

Cotest supports multiple test coroutines: these will see mock calls with priority established by their watches, which may be interleaved with GMock expectations. Cotest permits multiple overlapping launches of code under test: in the coroutine model there is no freely concurrent execution, but a test coroutine can control the order in which mock calls are allowed to return.

This project is a fork of Google Test, and changes to gtest/gmock source code have been kept minimal. C++14.

To build and run the tests

From repo top level:

mkdir build
cd build
cmake -Dcoro_build_tests=ON -Dgtest_build_tests=ON -Dgtest_build_samples=ON -Dgmock_build_tests=ON -DCMAKE_BUILD_TYPE=Debug -DGOOGLETEST_VERSION=0 -DCOROUTINES_VERSION=0 ../
make
ctest

This will run the googletest tests as well as the cotest tests. Use -R ^co for just the cotest tests.

Selected examples

• Unit tests for a code sample that (mis-)uses a mutex.
• Examples of serverised testing style.

There are many more cotest scripts in test/