Unit-testing (utest)

Detailed Description

Versions of gtest macros that run tests in a coroutine environment and other helpers.

There are the following extensions:

1. _MT ("multi-threaded") macro versions take 'thread_count' integer as the 3rd parameter at the test definition. It specifies the number of worker threads that should be created for the test. By default, there is only 1 worker thread, which should be enough for most tests;
2. GetThreadCount() method is available in the test scope.

Usage examples:

UTEST(Semaphore, PassAcrossCoroutines) {
    engine::Semaphore s{1};
    std::shared_lock guard{s};
 
    auto task = utils::Async("test", [guard = std::move(guard)] {});
    task.WaitFor(utest::kMaxTestWaitTime);
    EXPECT_TRUE(task.IsFinished());
}

UTEST_MT(SemaphoreLock, LockMoveCopyOwning, 2) {
    engine::Semaphore sem{1};
    engine::SemaphoreLock lock(sem);
    ASSERT_TRUE(lock.OwnsLock());
 
    const engine::SemaphoreLock move_here{std::move(lock)};
    // NOLINTNEXTLINE(bugprone-use-after-move,clang-analyzer-cplusplus.Move)
    EXPECT_FALSE(lock.OwnsLock());
    EXPECT_TRUE(move_here.OwnsLock());
}

See Unit Tests and Benchmarks for more usage examples and descriptions

Classes
struct	utest::PrintTestName
	Test name printer for parameterized tests written in gtest. More...
class	utest::HttpServerMock
	Toy HTTP server for testing; for raw TCP or TLS testing use utest::SimpleServer. More...
class	utest::SimpleServer
	Toy server for simple network testing; for testing HTTP prefer using utest::HttpServerMock. More...
struct	kafka::utest::Message
	Message owning data wrapper for unit tests. More...
class	kafka::utest::KafkaCluster
	Helper for Kafka unit testing. More...

Macros
#define	UTEST(test_suite_name, test_name)
	An equivalent of the gtest macro TEST that starts the test body as a coroutine task.
#define	UTEST_DEATH(test_suite_name, test_name)
	An equivalent of the gtest macro TEST for death tests that starts the test body as a coroutine task.
#define	UTEST_MT(test_suite_name, test_name, thread_count)
	An equivalent of the gtest macro TEST that starts the test body as a coroutine task.
#define	UTEST_F(test_suite_name, test_name)
	An equivalent of the gtest macro TEST_F that starts the test body as a coroutine task.
#define	UTEST_F_DEATH(test_suite_name, test_name)
	An equivalent of the gtest macro TEST_F for death tests that starts the test body as a coroutine task.
#define	UTEST_F_MT(test_suite_name, test_name, thread_count)
	An equivalent of the gtest macro TEST_F that starts the test body as a coroutine task.
#define	UTEST_P(test_suite_name, test_name)
	An equivalent of the gtest macro TEST_P that starts the test body as a coroutine task.
#define	UTEST_P_DEATH(test_suite_name, test_name)
	An equivalent of the gtest macro TEST_P for death tests that starts the test body as a coroutine task.
#define	UTEST_P_MT(test_suite_name, test_name, thread_count)
	An equivalent of the gtest macro TEST_P that starts the test body as a coroutine task.
#define	TYPED_UTEST(test_suite_name, test_name)
	An equivalent of the gtest macro TYPED_TEST that starts the test body as a coroutine task.
#define	TYPED_UTEST_MT(test_suite_name, test_name, thread_count)
	An equivalent of the gtest macro TYPED_TEST that starts the test body as a coroutine task.
#define	TYPED_UTEST_P(test_suite_name, test_name)
	An equivalent of the gtest macro TYPED_TEST_P that starts the test body as a coroutine task.
#define	TYPED_UTEST_P_MT(test_suite_name, test_name, thread_count)
	An equivalent of the gtest macro TYPED_TEST_P that starts the test body as a coroutine task.
#define	TYPED_UTEST_SUITE(test_suite_name, types)
	An equivalent of the gtest macro TYPED_TEST_SUITE that starts the test body as a coroutine task.
#define	INSTANTIATE_UTEST_SUITE_P(prefix, test_suite_name, ...)
	An equivalent of the gtest macro INSTANTIATE_TEST_SUITE_P that starts the test body as a coroutine task.
#define	REGISTER_TYPED_UTEST_SUITE_P(test_suite_name, ...)
	An equivalent of the gtest macro REGISTER_TYPED_TEST_SUITE_P that starts the test body as a coroutine task.
#define	INSTANTIATE_TYPED_UTEST_SUITE_P(prefix, test_suite_name, types)
	An equivalent of the gtest macro INSTANTIATE_TYPED_TEST_SUITE_P that starts the test body as a coroutine task.
#define	TYPED_UTEST_SUITE_P(test_suite_name)
	An equivalent of the gtest macro TYPED_TEST_SUITE_P that starts the test body as a coroutine task.
#define	UEXPECT_THROW_MSG(statement, exception_type, message_substring)
#define	UASSERT_THROW_MSG(statement, exception_type, message_substring)
#define	UEXPECT_THROW(statement, exception_type)
#define	UASSERT_THROW(statement, exception_type)
#define	UEXPECT_NO_THROW(statement)
#define	UASSERT_NO_THROW(statement)
#define	EXPECT_UINVARIANT_FAILURE(statement)
#define	UEXPECT_DEATH(statement, regex_or_matcher)
	An optimized equivalent of EXPECT_DEATH.
#define	UEXPECT_DEBUG_DEATH(statement, regex_or_matcher)
	An optimized equivalent of EXPECT_DEBUG_DEATH.

Macro Definition Documentation

EXPECT_UINVARIANT_FAILURE

#define EXPECT_UINVARIANT_FAILURE

(

statement

)

Test that a UINVARIANT check triggers

Definition at line 145 of file assert_macros.hpp.

INSTANTIATE_TYPED_UTEST_SUITE_P

#define INSTANTIATE_TYPED_UTEST_SUITE_P	(		prefix,
			test_suite_name,
			types
	)

An equivalent of the gtest macro INSTANTIATE_TYPED_TEST_SUITE_P that starts the test body as a coroutine task.

Definition at line 210 of file utest.hpp.

INSTANTIATE_UTEST_SUITE_P

#define INSTANTIATE_UTEST_SUITE_P	(		prefix,
			test_suite_name,
			...
	)

An equivalent of the gtest macro INSTANTIATE_TEST_SUITE_P that starts the test body as a coroutine task.

Definition at line 185 of file utest.hpp.

REGISTER_TYPED_UTEST_SUITE_P

#define REGISTER_TYPED_UTEST_SUITE_P	(		test_suite_name,
			...
	)

An equivalent of the gtest macro REGISTER_TYPED_TEST_SUITE_P that starts the test body as a coroutine task.

Definition at line 200 of file utest.hpp.

TYPED_UTEST

#define TYPED_UTEST	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TYPED_TEST that starts the test body as a coroutine task.

Definition at line 145 of file utest.hpp.

TYPED_UTEST_MT

#define TYPED_UTEST_MT	(		test_suite_name,
			test_name,
			thread_count
	)

An equivalent of the gtest macro TYPED_TEST that starts the test body as a coroutine task.

Parameters

thread_count

the number of threads to process tasks

Definition at line 152 of file utest.hpp.

TYPED_UTEST_P

#define TYPED_UTEST_P	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TYPED_TEST_P that starts the test body as a coroutine task.

Definition at line 159 of file utest.hpp.

TYPED_UTEST_P_MT

#define TYPED_UTEST_P_MT	(		test_suite_name,
			test_name,
			thread_count
	)

An equivalent of the gtest macro TYPED_TEST_P that starts the test body as a coroutine task.

Parameters

thread_count

the number of threads to process tasks

Definition at line 166 of file utest.hpp.

TYPED_UTEST_SUITE

#define TYPED_UTEST_SUITE	(		test_suite_name,
			types
	)

An equivalent of the gtest macro TYPED_TEST_SUITE that starts the test body as a coroutine task.

Definition at line 173 of file utest.hpp.

TYPED_UTEST_SUITE_P

#define TYPED_UTEST_SUITE_P

(

test_suite_name

)

An equivalent of the gtest macro TYPED_TEST_SUITE_P that starts the test body as a coroutine task.

Definition at line 225 of file utest.hpp.

UASSERT_NO_THROW

#define UASSERT_NO_THROW

(

statement

)

An equivalent to EXPECT_THROW with better diagnostics

Definition at line 125 of file assert_macros.hpp.

UASSERT_THROW

#define UASSERT_THROW	(		statement,
			exception_type
	)

An equivalent to ASSERT_THROW with better diagnostics

Definition at line 108 of file assert_macros.hpp.

UASSERT_THROW_MSG

#define UASSERT_THROW_MSG	(		statement,
			exception_type,
			message_substring
	)

An equivalent to ASSERT_THROW with an additional check for a message substring

Definition at line 90 of file assert_macros.hpp.

UEXPECT_DEATH

#define UEXPECT_DEATH	(		statement,
			regex_or_matcher
	)

An optimized equivalent of EXPECT_DEATH.

Definition at line 39 of file death_tests.hpp.

UEXPECT_DEBUG_DEATH

#define UEXPECT_DEBUG_DEATH	(		statement,
			regex_or_matcher
	)

An optimized equivalent of EXPECT_DEBUG_DEATH.

Definition at line 51 of file death_tests.hpp.

UEXPECT_NO_THROW

#define UEXPECT_NO_THROW

(

statement

)

An equivalent to EXPECT_NO_THROW with better diagnostics

Definition at line 117 of file assert_macros.hpp.

UEXPECT_THROW

#define UEXPECT_THROW	(		statement,
			exception_type
	)

An equivalent to EXPECT_THROW with better diagnostics

Definition at line 99 of file assert_macros.hpp.

UEXPECT_THROW_MSG

#define UEXPECT_THROW_MSG	(		statement,
			exception_type,
			message_substring
	)

An equivalent to EXPECT_THROW with an additional check for a message substring

Definition at line 80 of file assert_macros.hpp.

UTEST

#define UTEST	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST that starts the test body as a coroutine task.

Examples

samples/hello_service/unittests/say_hello_test.cpp, and samples/s3api/unittests/client_test.cpp.

Definition at line 86 of file utest.hpp.

UTEST_DEATH

#define UTEST_DEATH	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST for death tests that starts the test body as a coroutine task.

Definition at line 92 of file utest.hpp.

UTEST_F

#define UTEST_F	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST_F that starts the test body as a coroutine task.

Examples

samples/kafka_service/unittest/kafka_test.cpp.

Definition at line 106 of file utest.hpp.

UTEST_F_DEATH

#define UTEST_F_DEATH	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST_F for death tests that starts the test body as a coroutine task.

Definition at line 112 of file utest.hpp.

UTEST_F_MT

#define UTEST_F_MT	(		test_suite_name,
			test_name,
			thread_count
	)

An equivalent of the gtest macro TEST_F that starts the test body as a coroutine task.

Parameters

thread_count

the number of threads to process tasks

Definition at line 119 of file utest.hpp.

UTEST_MT

#define UTEST_MT	(		test_suite_name,
			test_name,
			thread_count
	)

An equivalent of the gtest macro TEST that starts the test body as a coroutine task.

Parameters

thread_count

the number of threads to process tasks

Definition at line 99 of file utest.hpp.

UTEST_P

#define UTEST_P	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST_P that starts the test body as a coroutine task.

Definition at line 126 of file utest.hpp.

UTEST_P_DEATH

#define UTEST_P_DEATH	(		test_suite_name,
			test_name
	)

An equivalent of the gtest macro TEST_P for death tests that starts the test body as a coroutine task.

Definition at line 132 of file utest.hpp.

UTEST_P_MT

#define UTEST_P_MT	(		test_suite_name,
			test_name,
			thread_count
	)

An equivalent of the gtest macro TEST_P that starts the test body as a coroutine task.

Definition at line 138 of file utest.hpp.