45 #include <OpenMS/OpenMSConfig.h>
46 #include <OpenMS/config.h>
58 #define stdcout std::cout
74 validate(
const std::vector<std::string>& file_names);
77 std::string OPENMS_DLLAPI
81 inline bool OPENMS_DLLAPI
88 inline bool OPENMS_DLLAPI
95 inline bool OPENMS_DLLAPI
102 inline bool OPENMS_DLLAPI
109 inline bool OPENMS_DLLAPI
116 template <
typename T>
130 const char* number_1_stringified,
131 bool number_1_is_realtype,
Int number_1_written_digits,
132 long double number_2,
const char* number_2_stringified,
133 bool ,
Int number_2_written_digits);
148 const std::string& string_1,
149 const char* string_1_stringified,
150 const std::string& string_2,
151 const char* string_2_stringified);
156 const std::string& string_1,
157 const char* string_1_stringified,
158 const std::string& string_2,
159 const char* string_2_stringified);
168 const std::string& filename_2);
187 void OPENMS_DLLAPI
mainInit(
const char* version,
const char* class_name,
int argc,
const char* argv0);
198 void OPENMS_DLLAPI
filesEqual(
int line,
const char* filename,
const char* templatename,
const char* filename_stringified,
const char* templatename_stringified);
206 const std::string& whitelist);
215 extern OPENMS_DLLAPI
double ratio;
224 extern OPENMS_DLLAPI
double absdiff;
230 extern OPENMS_DLLAPI
int verbose;
236 extern OPENMS_DLLAPI
bool test;
251 extern OPENMS_DLLAPI std::string
test_name;
269 extern OPENMS_DLLAPI std::ifstream
infile;
293 extern OPENMS_DLLAPI
bool newline;
295 template <
typename T1,
typename T2>
297 testEqual(
const char* ,
int line,
const T1& expression_1,
298 const char* expression_1_stringified,
299 const T2& expression_2,
300 const char* expression_2_stringified)
304 this_test = bool(expression_1 == T1(expression_2));
312 stdcout <<
" + line " << line <<
": TEST_EQUAL("
313 << expression_1_stringified <<
','
314 << expression_2_stringified <<
"): got '" << expression_1
315 <<
"', expected '" << expression_2 <<
"'\n";
320 stdcout <<
" - line " << line <<
": TEST_EQUAL("
321 << expression_1_stringified <<
','
322 << expression_2_stringified <<
"): got '" << expression_1
323 <<
"', expected '" << expression_2 <<
"'\n";
329 void testTrue(
const char* ,
int line,
const bool expression_1,
const char* expression_1_stringified)
341 stdcout <<
" + line " << line <<
": TEST_TRUE(" << expression_1_stringified <<
"): ok\n";
346 stdcout <<
" - line " << line <<
": TEST_TRUE(" << expression_1_stringified <<
"): failed\n";
352 void testFalse(
const char* ,
int line,
const bool expression_1,
const char* expression_1_stringified)
364 stdcout <<
" + line " << line <<
": TEST_FALSE(" << expression_1_stringified <<
"): ok\n";
369 stdcout <<
" - line " << line <<
": TEST_FALSE(" << expression_1_stringified <<
"): failed\n";
375 template <
typename T1,
typename T2>
378 const char* expression_1_stringified,
379 const T2& expression_2,
380 const char* expression_2_stringified)
384 this_test = !(expression_1 == T1(expression_2));
392 stdcout <<
" + line " << line <<
": TEST_NOT_EQUAL("
393 << expression_1_stringified <<
','
394 << expression_2_stringified <<
"): got '" << expression_1
395 <<
"', forbidden is '" << expression_2 <<
"'\n";
400 stdcout <<
" - line " << line <<
": TEST_NOT_EQUAL("
401 << expression_1_stringified <<
','
402 << expression_2_stringified <<
"): got '" << expression_1
403 <<
"', forbidden is '" << expression_2 <<
"'\n";
474 #define START_TEST(class_name, version) \
475 int main(int argc, char** argv) \
477 TEST::mainInit(version, #class_name, argc, argv[0]); \
496 TEST::printLastException(stdcout); \
498 return TEST::endTestPostProcess(stdcout); \
523 #define START_SECTION(name_of_test) \
525 TEST::newline = false; \
526 TEST::test_name = # name_of_test; \
527 TEST::test_count = 0; \
528 TEST::start_section_line = __LINE__; \
529 stdcout << "checking " << TEST::test_name << " ... " << std::flush; \
560 #define END_SECTION \
566 TEST::printLastException(stdcout);\
568 TEST::endSectionPostProcess(stdcout, __LINE__);
592 #define TEST_EQUAL(a, b) TEST::testEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
603 #define TEST_TRUE(a) TEST::testTrue(__FILE__, __LINE__, (a), (#a));
614 #define TEST_FALSE(a) TEST::testFalse(__FILE__, __LINE__, (a), (#a));
628 #define TEST_NOT_EQUAL(a, b) TEST::testNotEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
642 #define TEST_STRING_EQUAL(a, b) TEST::testStringEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
658 #define TEST_FILE_EQUAL(filename, templatename) \
660 TEST::filesEqual(__LINE__, filename, templatename, #filename, #templatename); \
678 #define TEST_REAL_SIMILAR(a, b) TEST::testRealSimilar(__FILE__, __LINE__, (a), (# a), TEST::isRealType(a), writtenDigits(a), (b), (# b), TEST::isRealType(b), writtenDigits(b));
695 #define TEST_STRING_SIMILAR(a, b) TEST::testStringSimilar(__FILE__, __LINE__, (a), (# a), (b), (# b));
711 #define TEST_FILE_SIMILAR(a, b) \
713 ++TEST::test_count; \
714 TEST::test_line = __LINE__; \
715 TEST::this_test = TEST::isFileSimilar((a), (b)); \
716 TEST::test = TEST::test && TEST::this_test; \
718 TEST::initialNewline(); \
719 if (TEST::this_test) \
721 if (TEST::verbose > 1) \
723 stdcout << " + line " << __LINE__ \
724 << ": TEST_FILE_SIMILAR(" # a "," # b "): absolute: " \
725 << precisionWrapper(TEST::absdiff) \
727 << precisionWrapper(TEST::absdiff_max_allowed) \
729 << precisionWrapper(TEST::ratio) \
731 << precisionWrapper(TEST::ratio_max_allowed) \
733 stdcout << "message: \n"; \
734 stdcout << TEST::fuzzy_message; \
739 stdcout << " - line " << TEST::test_line << \
740 ": TEST_FILE_SIMILAR(" # a "," # b ") ... -\n"; \
741 stdcout << "message: \n"; \
742 stdcout << TEST::fuzzy_message; \
743 TEST::failed_lines_list.push_back(TEST::test_line); \
760 #define TOLERANCE_RELATIVE(a) \
761 TEST::ratio_max_allowed = (a); \
763 TEST::initialNewline(); \
764 if (TEST::verbose > 1) \
766 stdcout << " + line " << __LINE__ << \
767 ": TOLERANCE_RELATIVE(" << TEST::ratio_max_allowed << \
768 ") (\"" # a "\")\n"; \
783 #define TOLERANCE_ABSOLUTE(a) \
784 TEST::absdiff_max_allowed = (a); \
786 TEST::initialNewline(); \
787 if (TEST::verbose > 1) \
789 stdcout << " + line " << __LINE__ << \
790 ": TOLERANCE_ABSOLUTE(" << TEST::absdiff_max_allowed << \
791 ") (\"" # a "\")\n"; \
800 #define WHITELIST(a) TEST::setWhitelist(__FILE__, __LINE__, (a));
814 #define TEST_EXCEPTION(exception_type, command) \
816 ++TEST::test_count; \
817 TEST::test_line = __LINE__; \
818 TEST::exception = 0; \
823 catch (exception_type&) \
825 TEST::exception = 1; \
827 catch (::OpenMS::Exception::BaseException& e) \
829 TEST::exception = 2; \
830 TEST::exception_name = e.getName(); \
832 catch (const std::exception& e) \
834 TEST::exception = 3; \
835 TEST::exception_name = e.what(); \
839 TEST::exception = 4; \
841 TEST::this_test = (TEST::exception == 1); \
842 TEST::test = TEST::test && TEST::this_test; \
844 TEST::initialNewline(); \
845 switch (TEST::exception) \
848 stdcout << " - line " << TEST::test_line << \
849 ": TEST_EXCEPTION(" # exception_type "," # command \
850 "): no exception thrown!\n"; \
851 TEST::failed_lines_list.push_back(TEST::test_line); \
854 if (TEST::verbose > 1) \
856 stdcout << " + line " << TEST::test_line << \
857 ": TEST_EXCEPTION(" # exception_type "," # command \
862 stdcout << " - line " << TEST::test_line << \
863 ": TEST_EXCEPTION(" # exception_type "," # command \
864 "): wrong exception thrown! \"" \
865 << TEST::exception_name << "\"\n"; \
866 TEST::failed_lines_list.push_back(TEST::test_line); \
869 stdcout << " - line " << TEST::test_line << \
870 ": TEST_EXCEPTION(" # exception_type "," # command \
871 "): wrong exception thrown! \"" \
872 << TEST::exception_name << "\"\n"; \
873 TEST::failed_lines_list.push_back(TEST::test_line); \
876 stdcout << " - line " << TEST::test_line << \
877 ": TEST_EXCEPTION(" # exception_type "," # command \
878 "): wrong exception thrown!\n"; \
879 TEST::failed_lines_list.push_back(TEST::test_line); \
896 #ifdef OPENMS_ASSERTIONS
897 #define TEST_PRECONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Precondition, command);
899 #define TEST_PRECONDITION_VIOLATED(command) STATUS("TEST_PRECONDITION_VIOLATED(" # command ") - skipped");
913 #ifdef OPENMS_ASSERTIONS
914 #define TEST_POSTCONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Postcondition, command);
916 #define TEST_POSTCONDITION_VIOLATED(command) STATUS("TEST_POSTCONDITION_VIOLATED(" # command ") - skipped");
936 #define TEST_EXCEPTION_WITH_MESSAGE(exception_type, command, message) \
938 ++TEST::test_count; \
939 TEST::test_line = __LINE__; \
940 TEST::exception = 0; \
945 catch (exception_type& et) \
947 if (std::string(et.what()) != std::string(message)) \
949 TEST::exception = 4; \
950 TEST::exception_message = et.what(); \
952 else TEST::exception = 1; \
954 catch (::OpenMS::Exception::BaseException& e) \
956 TEST::exception = 2; \
957 TEST::exception_name = e.getName(); \
961 TEST::exception = 3; \
963 TEST::this_test = (TEST::exception == 1); \
964 TEST::test = TEST::test && TEST::this_test; \
967 TEST::initialNewline(); \
968 switch (TEST::exception) \
971 stdcout << " - line " << TEST::test_line << \
972 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
973 "): no exception thrown!\n"; \
974 TEST::failed_lines_list.push_back(TEST::test_line); \
977 if (TEST::verbose > 1) \
980 stdcout << " + line " << TEST::test_line << \
981 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
986 stdcout << " - line " << TEST::test_line << \
987 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
988 "): wrong exception thrown! \"" << \
989 TEST::exception_name << "\"\n"; \
990 TEST::failed_lines_list.push_back(TEST::test_line); \
993 stdcout << " - line " << TEST::test_line << \
994 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
995 "): wrong exception thrown!\n"; \
996 TEST::failed_lines_list.push_back(TEST::test_line); \
999 stdcout << " - line " << TEST::test_line << \
1000 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
1001 "): exception has wrong message: got '" << \
1002 TEST::exception_message << \
1003 "', expected '" << \
1004 (message) << "'\n"; \
1005 TEST::failed_lines_list.push_back(TEST::test_line); \
1026 #define NEW_TMP_FILE(filename) \
1028 filename = TEST::tmpFileName(__FILE__, __LINE__); \
1029 TEST::tmp_file_list.push_back(filename); \
1031 TEST::initialNewline(); \
1032 stdcout << " creating new temporary filename '" \
1047 #define ABORT_IF(condition) \
1051 TEST::test_line = __LINE__; \
1052 TEST::this_test = false; \
1053 TEST::test = TEST::test && TEST::this_test; \
1054 TEST::failed_lines_list.push_back(TEST::test_line); \
1055 TEST::initialNewline(); \
1056 stdcout << " - line " << TEST::test_line << \
1057 ": ABORT_IF(" # condition "): TEST ABORTED\n"; \
1079 #define STATUS(message) \
1081 TEST::initialNewline(); \
1082 stdcout << " line " \
1098 #define ADD_MESSAGE(message) \
1099 TEST::add_message = message;
1110 #define NOT_TESTABLE \
1111 TEST::test_count = 1;
#define stdcout
Provide a point of redirection for testing the test macros, see ClassTest_test.cpp.
Definition: ClassTest.h:58
Class to hold strings, numeric values, lists of strings and lists of numeric values.
Definition: DataValue.h:59
Class to hold strings, numeric values, vectors of strings and vectors of numeric values using the stl...
Definition: ParamValue.h:55
int Int
Signed integer type.
Definition: Types.h:102
Namespace for class tests.
Definition: ClassTest.h:67
double ratio_max
Maximum ratio of numbers observed so far, see TOLERANCE_RELATIVE.
int verbose
Verbosity level ( "-v" is 1 and "-V" is 2 )
int test_count
Counter for the number of elementary tests within the current subsection.
int endTestPostProcess(std::ostream &out)
void initialNewline()
make sure we have a newline before results from first subtest
void testStringSimilar(const char *file, int line, const std::string &string_1, const char *string_1_stringified, const std::string &string_2, const char *string_2_stringified)
Compare strings using absdiff_max_allowed and ratio_max_allowed.
void endSectionPostProcess(std::ostream &out, const int line)
void testEqual(const char *, int line, const T1 &expression_1, const char *expression_1_stringified, const T2 &expression_2, const char *expression_2_stringified)
Definition: ClassTest.h:297
int test_line
Line of current elementary test.
void testRealSimilar(const char *file, int line, long double number_1, const char *number_1_stringified, bool number_1_is_realtype, Int number_1_written_digits, long double number_2, const char *number_2_stringified, bool, Int number_2_written_digits)
Compare floating point numbers using absdiff_max_allowed and ratio_max_allowed.
double absdiff
Recent absolute difference of numbers, see TOLERANCE_ABSOLUTE.
char line_buffer[65536]
(A buffer for one line from a file. Used by TEST_FILE_EQUAL.)
std::string add_message
See ADD_MESSAGE.
bool validate(const std::vector< std::string > &file_names)
Validates the given files against the XML schema (if available)
std::string fuzzy_message
Last message from a fuzzy comparison. Written by isRealSimilar(), testStringSimilar(),...
void mainInit(const char *version, const char *class_name, int argc, const char *argv0)
Set up some classtest variables as obtained from the 'START_TEST' macro and check that no additional ...
bool all_tests
Status of the whole test.
std::string exception_message
(Used by various macros. Stores the "message" of the exception, if applicable.)
std::string test_name
Name of current subsection.
void testStringEqual(const char *file, int line, const std::string &string_1, const char *string_1_stringified, const std::string &string_2, const char *string_2_stringified)
used by TEST_STRING_EQUAL
double absdiff_max
Maximum difference of numbers observed so far, see TOLERANCE_ABSOLUTE.
void printWithPrefix(const std::string &text, const int marked=-1)
print the text, each line gets a prefix, the marked line number gets a special prefix
bool newline
(Flags whether a new line is in place, depending on context and verbosity setting....
std::string tmpFileName(const std::string &file, int line)
Creates a temporary file name from the test name and the line.
bool test
Status of the current subsection.
double absdiff_max_allowed
Maximum absolute difference of numbers allowed, see TOLERANCE_ABSOLUTE.
const char * version_string
Version string supplied with START_TEST.
std::ifstream infile
Questionable file tested by TEST_FILE_EQUAL.
void testTrue(const char *, int line, const bool expression_1, const char *expression_1_stringified)
Definition: ClassTest.h:329
void testFalse(const char *, int line, const bool expression_1, const char *expression_1_stringified)
Definition: ClassTest.h:352
std::string exception_name
(Used by various macros. Stores the "name" of the exception, if applicable.)
std::vector< UInt > failed_lines_list
List of all failed lines for summary at the end of the test.
void removeTempFiles()
removed all temporary files created with the NEW_TMP_FILE macro
double ratio
Recent ratio of numbers, see TOLERANCE_RELATIVE.
std::vector< std::string > tmp_file_list
List of tmp file names (these will be cleaned up, see NEW_TMP_FILE)
bool isFileSimilar(const std::string &filename_1, const std::string &filename_2)
Compare files using absdiff_max_allowed and ratio_max_allowed.
void testNotEqual(const char *, int line, const T1 &expression_1, const char *expression_1_stringified, const T2 &expression_2, const char *expression_2_stringified)
Definition: ClassTest.h:377
bool this_test
Status of last elementary test.
std::ifstream templatefile
Template (correct) file used by TEST_FILE_EQUAL.
double ratio_max_allowed
Maximum ratio of numbers allowed, see TOLERANCE_RELATIVE.
void setWhitelist(const char *const, const int line, const std::string &whitelist)
set the whitelist_
bool isRealType(float)
This overload returns true; float is a floating point type.
Definition: ClassTest.h:82
bool equal_files
(A variable used by TEST_FILE_EQUAL)
int start_section_line
Line where current subsection started.
void filesEqual(int line, const char *filename, const char *templatename, const char *filename_stringified, const char *templatename_stringified)
Test if two files are exactly equal (used in TEST_FILE_EQUAL macro)
void printLastException(std::ostream &out)
int exception
(Used by various macros. Indicates a rough category of the exception being caught....
bool isRealSimilar(long double number_1, long double number_2)
used by testRealSimilar()
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48