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));
310 stdcout <<
" + line " << line <<
": TEST_EQUAL("
311 << expression_1_stringified <<
','
312 << expression_2_stringified <<
"): got '" << expression_1
313 <<
"', expected '" << expression_2 <<
"'\n";
317 stdcout <<
" - line " << line <<
": TEST_EQUAL("
318 << expression_1_stringified <<
','
319 << expression_2_stringified <<
"): got '" << expression_1
320 <<
"', expected '" << expression_2 <<
"'\n";
326 template <
typename T1,
typename T2>
329 const char* expression_1_stringified,
330 const T2& expression_2,
331 const char* expression_2_stringified)
335 this_test = !(expression_1 == T1(expression_2));
341 stdcout <<
" + line " << line <<
": TEST_NOT_EQUAL("
342 << expression_1_stringified <<
','
343 << expression_2_stringified <<
"): got '" << expression_1
344 <<
"', forbidden is '" << expression_2 <<
"'\n";
348 stdcout <<
" - line " << line <<
": TEST_NOT_EQUAL("
349 << expression_1_stringified <<
','
350 << expression_2_stringified <<
"): got '" << expression_1
351 <<
"', forbidden is '" << expression_2 <<
"'\n";
416 #define START_TEST(class_name, version) \
417 int main(int argc, char** argv) \
419 TEST::mainInit(version, #class_name, argc, argv[0]); \
436 catch (::OpenMS::Exception::BaseException& e) \
438 TEST::this_test = false; \
439 TEST::test = false; \
440 TEST::all_tests = false; \
442 TEST::initialNewline(); \
443 stdcout << "Error: Caught unexpected OpenMS exception of type '" \
446 if ((e.getLine() > 0) && std::strcmp(e.getFile(), "")) \
448 stdcout << " thrown in line " << e.getLine() << " of file '" << e.getFile() \
449 << "' in function '" << e.getFunction() << "'"; \
451 stdcout << " - Message: " << e.what() << std::endl; \
455 catch (std::exception& e) \
457 TEST::this_test = false; \
458 TEST::test = false; \
459 TEST::all_tests = false; \
461 TEST::initialNewline(); \
462 stdcout << "Error: Caught unexpected std::exception\n"; \
463 stdcout << " - Message: " << e.what() << std::endl; \
469 TEST::this_test = false; \
470 TEST::test = false; \
471 TEST::all_tests = false; \
473 TEST::initialNewline(); \
474 stdcout << "Error: Caught unidentified and unexpected exception - No message." \
479 if (!TEST::validate(TEST::tmp_file_list)) \
481 TEST::all_tests = false; \
484 if (!TEST::all_tests) \
486 stdcout << "FAILED" << std::endl; \
487 if (TEST::add_message != "") stdcout << "Message: " \
488 << TEST::add_message \
490 stdcout << "Failed lines: "; \
491 for (OpenMS::Size i = 0; i < TEST::failed_lines_list.size(); ++i) \
493 stdcout << TEST::failed_lines_list[i] << " "; \
495 stdcout << std::endl; \
501 TEST::removeTempFiles(); \
502 stdcout << "PASSED"; \
503 if (TEST::add_message != "") stdcout << " (" << TEST::add_message << ")"; \
504 stdcout << std::endl; \
531 #define START_SECTION(name_of_test) \
533 TEST::newline = false; \
534 TEST::test_name = # name_of_test; \
535 TEST::test_count = 0; \
536 TEST::start_section_line = __LINE__; \
537 stdcout << "checking " << TEST::test_name << " ... " << std::flush; \
568 #define END_SECTION \
572 catch (::OpenMS::Exception::BaseException& e) \
574 TEST::this_test = false; \
575 TEST::test = false; \
576 TEST::all_tests = false; \
578 TEST::initialNewline(); \
579 stdcout << "Error: Caught unexpected exception of type '" << e.getName() << "'"; \
580 if ((e.getLine() > 0) && (std::strcmp(e.getFile(), "") != 0)) \
582 stdcout << " thrown in line " << e.getLine() << " of file '" << e.getFile() \
583 << "' in function '" << e.getFunction() << "'"; \
585 stdcout << " - Message: " << e.what() << std::endl; \
589 catch (std::exception& e) \
591 TEST::this_test = false; \
592 TEST::test = false; \
593 TEST::all_tests = false; \
595 TEST::initialNewline(); \
596 stdcout << "Error: Caught std::exception" << std::endl; \
597 stdcout << " - Message: " << e.what() << std::endl; \
603 TEST::this_test = false; \
604 TEST::test = false; \
605 TEST::all_tests = false; \
607 TEST::initialNewline(); \
608 stdcout << "Error: Caught unidentified and unexpected exception - No message." \
612 TEST::all_tests = TEST::all_tests && TEST::test; \
616 stdcout << ": passed\n"; \
620 stdcout << ": failed\n"; \
624 if (TEST::test_count == 0) \
626 if (OpenMS::String(TEST::test_name).has('~')) \
627 stdcout << "Warning: no subtests performed in '" \
633 stdcout << std::endl;
656 #define TEST_EQUAL(a, b) TEST::testEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
669 #define TEST_NOT_EQUAL(a, b) TEST::testNotEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
683 #define TEST_STRING_EQUAL(a, b) TEST::testStringEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
699 #define TEST_FILE_EQUAL(filename, templatename) \
701 TEST::filesEqual(__LINE__, filename, templatename, #filename, #templatename); \
719 #define TEST_REAL_SIMILAR(a, b) TEST::testRealSimilar(__FILE__, __LINE__, (a), (# a), TEST::isRealType(a), writtenDigits(a), (b), (# b), TEST::isRealType(b), writtenDigits(b));
736 #define TEST_STRING_SIMILAR(a, b) TEST::testStringSimilar(__FILE__, __LINE__, (a), (# a), (b), (# b));
752 #define TEST_FILE_SIMILAR(a, b) \
754 ++TEST::test_count; \
755 TEST::test_line = __LINE__; \
756 TEST::this_test = TEST::isFileSimilar((a), (b)); \
757 TEST::test = TEST::test && TEST::this_test; \
759 TEST::initialNewline(); \
760 if (TEST::this_test) \
762 stdcout << " + line " << __LINE__ \
763 << ": TEST_FILE_SIMILAR(" # a "," # b "): absolute: " \
764 << precisionWrapper(TEST::absdiff) \
766 << precisionWrapper(TEST::absdiff_max_allowed) \
768 << precisionWrapper(TEST::ratio) \
770 << precisionWrapper(TEST::ratio_max_allowed) \
772 stdcout << "message: \n"; \
773 stdcout << TEST::fuzzy_message; \
777 stdcout << " - line " << TEST::test_line << \
778 ": TEST_FILE_SIMILAR(" # a "," # b ") ... -\n"; \
779 stdcout << "message: \n"; \
780 stdcout << TEST::fuzzy_message; \
781 TEST::failed_lines_list.push_back(TEST::test_line); \
798 #define TOLERANCE_RELATIVE(a) \
799 TEST::ratio_max_allowed = (a); \
801 TEST::initialNewline(); \
802 stdcout << " + line " << __LINE__ << \
803 ": TOLERANCE_RELATIVE(" << TEST::ratio_max_allowed << \
804 ") (\"" # a "\")\n"; \
818 #define TOLERANCE_ABSOLUTE(a) \
819 TEST::absdiff_max_allowed = (a); \
821 TEST::initialNewline(); \
822 stdcout << " + line " << __LINE__ << \
823 ": TOLERANCE_ABSOLUTE(" << TEST::absdiff_max_allowed << \
824 ") (\"" # a "\")\n"; \
832 #define WHITELIST(a) TEST::setWhitelist(__FILE__, __LINE__, (a));
846 #define TEST_EXCEPTION(exception_type, command) \
848 ++TEST::test_count; \
849 TEST::test_line = __LINE__; \
850 TEST::exception = 0; \
855 catch (exception_type&) \
857 TEST::exception = 1; \
859 catch (::OpenMS::Exception::BaseException& e) \
861 TEST::exception = 2; \
862 TEST::exception_name = e.getName(); \
866 TEST::exception = 3; \
868 TEST::this_test = (TEST::exception == 1); \
869 TEST::test = TEST::test && TEST::this_test; \
872 TEST::initialNewline(); \
873 switch (TEST::exception) \
876 stdcout << " - line " << TEST::test_line << \
877 ": TEST_EXCEPTION(" # exception_type "," # command \
878 "): no exception thrown!\n"; \
879 TEST::failed_lines_list.push_back(TEST::test_line); \
882 stdcout << " + line " << TEST::test_line << \
883 ": TEST_EXCEPTION(" # exception_type "," # command \
887 stdcout << " - line " << TEST::test_line << \
888 ": TEST_EXCEPTION(" # exception_type "," # command \
889 "): wrong exception thrown! \"" \
890 << TEST::exception_name << "\"\n"; \
891 TEST::failed_lines_list.push_back(TEST::test_line); \
894 stdcout << " - line " << TEST::test_line << \
895 ": TEST_EXCEPTION(" # exception_type "," # command \
896 "): wrong exception thrown!\n"; \
897 TEST::failed_lines_list.push_back(TEST::test_line); \
914 #ifdef OPENMS_ASSERTIONS
915 #define TEST_PRECONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Precondition, command);
917 #define TEST_PRECONDITION_VIOLATED(command) STATUS("TEST_PRECONDITION_VIOLATED(" # command ") - skipped");
931 #ifdef OPENMS_ASSERTIONS
932 #define TEST_POSTCONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Postcondition, command);
934 #define TEST_POSTCONDITION_VIOLATED(command) STATUS("TEST_POSTCONDITION_VIOLATED(" # command ") - skipped");
954 #define TEST_EXCEPTION_WITH_MESSAGE(exception_type, command, message) \
956 ++TEST::test_count; \
957 TEST::test_line = __LINE__; \
958 TEST::exception = 0; \
963 catch (exception_type& et) \
965 if (std::string(et.what()) != std::string(message)) \
967 TEST::exception = 4; \
968 TEST::exception_message = et.what(); \
970 else TEST::exception = 1; \
972 catch (::OpenMS::Exception::BaseException& e) \
974 TEST::exception = 2; \
975 TEST::exception_name = e.getName(); \
979 TEST::exception = 3; \
981 TEST::this_test = (TEST::exception == 1); \
982 TEST::test = TEST::test && TEST::this_test; \
985 TEST::initialNewline(); \
986 switch (TEST::exception) \
989 stdcout << " - line " << TEST::test_line << \
990 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
991 "): no exception thrown!\n"; \
992 TEST::failed_lines_list.push_back(TEST::test_line); \
996 stdcout << " + line " << TEST::test_line << \
997 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
1001 stdcout << " - line " << TEST::test_line << \
1002 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
1003 "): wrong exception thrown! \"" << \
1004 TEST::exception_name << "\"\n"; \
1005 TEST::failed_lines_list.push_back(TEST::test_line); \
1008 stdcout << " - line " << TEST::test_line << \
1009 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
1010 "): wrong exception thrown!\n"; \
1011 TEST::failed_lines_list.push_back(TEST::test_line); \
1014 stdcout << " - line " << TEST::test_line << \
1015 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
1016 "): exception has wrong message: got '" << \
1017 TEST::exception_message << \
1018 "', expected '" << \
1019 (message) << "'\n"; \
1020 TEST::failed_lines_list.push_back(TEST::test_line); \
1041 #define NEW_TMP_FILE(filename) \
1043 filename = TEST::tmpFileName(__FILE__, __LINE__); \
1044 TEST::tmp_file_list.push_back(filename); \
1046 TEST::initialNewline(); \
1047 stdcout << " creating new temporary filename '" \
1062 #define ABORT_IF(condition) \
1066 TEST::test_line = __LINE__; \
1067 TEST::this_test = false; \
1068 TEST::test = TEST::test && TEST::this_test; \
1069 TEST::failed_lines_list.push_back(TEST::test_line); \
1070 TEST::initialNewline(); \
1071 stdcout << " - line " << TEST::test_line << \
1072 ": ABORT_IF(" # condition "): TEST ABORTED\n"; \
1094 #define STATUS(message) \
1096 TEST::initialNewline(); \
1097 stdcout << " line " \
1113 #define ADD_MESSAGE(message) \
1114 TEST::add_message = message;
1125 #define NOT_TESTABLE \
1126 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:53
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.
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 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.
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:328
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)
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:47