44 lines
1.1 KiB
C++
44 lines
1.1 KiB
C++
///
|
|
/// \file Test.h
|
|
/// \author K. Isom <kyle@imap.cc>
|
|
/// \date 2023-10-09
|
|
/// \brief Test.h implements basic testing tools.
|
|
///
|
|
#ifndef KLIB_TEST_H
|
|
#define KLIB_TEST_H
|
|
|
|
#include <string>
|
|
|
|
|
|
namespace klib {
|
|
|
|
|
|
/// TestAssert is a variant on the assert macro. This variant is intended to be
|
|
/// a drop-in replacement for the cassert macro: even in release mode, the tests
|
|
/// should still run.
|
|
///
|
|
/// If NDEBUG is set, TestAssert will throw an exception if condition is false.
|
|
/// Otherwise, it calls assert after printing the message.
|
|
///
|
|
/// \param condition If true, TestAssert throws an exception.
|
|
void TestAssert(bool condition);
|
|
|
|
|
|
/// TestAssert is a variant on the assert macro.
|
|
///
|
|
/// If NDEBUG is set, TestAssert will throw an exception if condition is false.
|
|
/// Otherwise, it calls assert after printing the message.
|
|
///
|
|
/// In addition to NDEBUG, KLIB_NO_ASSERT will suppress assertions.
|
|
///
|
|
/// \throws AssertionFailed
|
|
///
|
|
/// \param condition The condition to assert.
|
|
/// \param message The message that should be displayed if condition is false.
|
|
void TestAssert(bool condition, std::string message);
|
|
|
|
|
|
} // namespace klib
|
|
|
|
#endif //KLIB_TEST_H
|