19 #include <OpenMS/OpenMSConfig.h>
20 #include <OpenMS/config.h>
32 #define stdcout std::cout
48 validate(
const std::vector<std::string>& file_names);
51 std::string OPENMS_DLLAPI
55 inline bool OPENMS_DLLAPI
62 inline bool OPENMS_DLLAPI
69 inline bool OPENMS_DLLAPI
76 inline bool OPENMS_DLLAPI
83 inline bool OPENMS_DLLAPI
104 const char* number_1_stringified,
105 bool number_1_is_realtype,
Int number_1_written_digits,
106 long double number_2,
const char* number_2_stringified,
107 bool ,
Int number_2_written_digits);
122 const std::string& string_1,
123 const char* string_1_stringified,
124 const std::string& string_2,
125 const char* string_2_stringified);
130 const std::string& string_1,
131 const char* string_1_stringified,
132 const std::string& string_2,
133 const char* string_2_stringified);
142 const std::string& filename_2);
161 void OPENMS_DLLAPI
mainInit(
const char* version,
const char* class_name,
int argc,
const char* argv0);
172 void OPENMS_DLLAPI
filesEqual(
int line,
const char* filename,
const char* templatename,
const char* filename_stringified,
const char* templatename_stringified);
180 const std::string& whitelist);
189 extern OPENMS_DLLAPI
double ratio;
198 extern OPENMS_DLLAPI
double absdiff;
204 extern OPENMS_DLLAPI
int verbose;
210 extern OPENMS_DLLAPI
bool test;
225 extern OPENMS_DLLAPI std::string
test_name;
243 extern OPENMS_DLLAPI std::ifstream
infile;
267 extern OPENMS_DLLAPI
bool newline;
269 template <
typename T1,
typename T2>
271 testEqual(
const char* ,
int line,
const T1& expression_1,
272 const char* expression_1_stringified,
273 const T2& expression_2,
274 const char* expression_2_stringified)
278 this_test = bool(expression_1 == T1(expression_2));
286 stdcout <<
" + line " << line <<
": TEST_EQUAL("
287 << expression_1_stringified <<
','
288 << expression_2_stringified <<
"): got '" << expression_1
289 <<
"', expected '" << expression_2 <<
"'\n";
294 stdcout <<
" - line " << line <<
": TEST_EQUAL("
295 << expression_1_stringified <<
','
296 << expression_2_stringified <<
"): got '" << expression_1
297 <<
"', expected '" << expression_2 <<
"'\n";
303 void testTrue(
const char* ,
int line,
const bool expression_1,
const char* expression_1_stringified)
315 stdcout <<
" + line " << line <<
": TEST_TRUE(" << expression_1_stringified <<
"): ok\n";
320 stdcout <<
" - line " << line <<
": TEST_TRUE(" << expression_1_stringified <<
"): failed\n";
326 void testFalse(
const char* ,
int line,
const bool expression_1,
const char* expression_1_stringified)
338 stdcout <<
" + line " << line <<
": TEST_FALSE(" << expression_1_stringified <<
"): ok\n";
343 stdcout <<
" - line " << line <<
": TEST_FALSE(" << expression_1_stringified <<
"): failed\n";
349 template <
typename T1,
typename T2>
352 const char* expression_1_stringified,
353 const T2& expression_2,
354 const char* expression_2_stringified)
358 this_test = !(expression_1 == T1(expression_2));
366 stdcout <<
" + line " << line <<
": TEST_NOT_EQUAL("
367 << expression_1_stringified <<
','
368 << expression_2_stringified <<
"): got '" << expression_1
369 <<
"', forbidden is '" << expression_2 <<
"'\n";
374 stdcout <<
" - line " << line <<
": TEST_NOT_EQUAL("
375 << expression_1_stringified <<
','
376 << expression_2_stringified <<
"): got '" << expression_1
377 <<
"', forbidden is '" << expression_2 <<
"'\n";
448 #define START_TEST(class_name, version) \
449 int main(int argc, char** argv) \
451 TEST::mainInit(version, #class_name, argc, argv[0]); \
470 TEST::printLastException(stdcout); \
472 return TEST::endTestPostProcess(stdcout); \
497 #define START_SECTION(name_of_test) \
499 TEST::newline = false; \
500 TEST::test_name = # name_of_test; \
501 TEST::test_count = 0; \
502 TEST::start_section_line = __LINE__; \
503 stdcout << "checking " << TEST::test_name << " ... " << std::flush; \
534 #define END_SECTION \
540 TEST::printLastException(stdcout);\
542 TEST::endSectionPostProcess(stdcout, __LINE__);
566 #define TEST_EQUAL(a, b) TEST::testEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
577 #define TEST_TRUE(a) TEST::testTrue(__FILE__, __LINE__, (a), (#a));
588 #define TEST_FALSE(a) TEST::testFalse(__FILE__, __LINE__, (a), (#a));
602 #define TEST_NOT_EQUAL(a, b) TEST::testNotEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
616 #define TEST_STRING_EQUAL(a, b) TEST::testStringEqual(__FILE__, __LINE__, (a), (# a), (b), (# b));
632 #define TEST_FILE_EQUAL(filename, templatename) \
634 TEST::filesEqual(__LINE__, filename, templatename, #filename, #templatename); \
652 #define TEST_REAL_SIMILAR(a, b) TEST::testRealSimilar(__FILE__, __LINE__, (a), (# a), TEST::isRealType(a), writtenDigits(a), (b), (# b), TEST::isRealType(b), writtenDigits(b));
669 #define TEST_STRING_SIMILAR(a, b) TEST::testStringSimilar(__FILE__, __LINE__, (a), (# a), (b), (# b));
685 #define TEST_FILE_SIMILAR(a, b) \
687 ++TEST::test_count; \
688 TEST::test_line = __LINE__; \
689 TEST::this_test = TEST::isFileSimilar((a), (b)); \
690 TEST::test = TEST::test && TEST::this_test; \
692 TEST::initialNewline(); \
693 if (TEST::this_test) \
695 if (TEST::verbose > 1) \
697 stdcout << " + line " << __LINE__ \
698 << ": TEST_FILE_SIMILAR(" # a "," # b "): absolute: " \
699 << precisionWrapper(TEST::absdiff) \
701 << precisionWrapper(TEST::absdiff_max_allowed) \
703 << precisionWrapper(TEST::ratio) \
705 << precisionWrapper(TEST::ratio_max_allowed) \
707 stdcout << "message: \n"; \
708 stdcout << TEST::fuzzy_message; \
713 stdcout << " - line " << TEST::test_line << \
714 ": TEST_FILE_SIMILAR(" # a "," # b ") ... -\n"; \
715 stdcout << "message: \n"; \
716 stdcout << TEST::fuzzy_message; \
717 TEST::failed_lines_list.push_back(TEST::test_line); \
734 #define TOLERANCE_RELATIVE(a) \
735 TEST::ratio_max_allowed = (a); \
737 TEST::initialNewline(); \
738 if (TEST::verbose > 1) \
740 stdcout << " + line " << __LINE__ << \
741 ": TOLERANCE_RELATIVE(" << TEST::ratio_max_allowed << \
742 ") (\"" # a "\")\n"; \
757 #define TOLERANCE_ABSOLUTE(a) \
758 TEST::absdiff_max_allowed = (a); \
760 TEST::initialNewline(); \
761 if (TEST::verbose > 1) \
763 stdcout << " + line " << __LINE__ << \
764 ": TOLERANCE_ABSOLUTE(" << TEST::absdiff_max_allowed << \
765 ") (\"" # a "\")\n"; \
774 #define WHITELIST(a) TEST::setWhitelist(__FILE__, __LINE__, (a));
788 #define TEST_EXCEPTION(exception_type, command) \
790 ++TEST::test_count; \
791 TEST::test_line = __LINE__; \
792 TEST::exception = 0; \
797 catch (exception_type&) \
799 TEST::exception = 1; \
801 catch (::OpenMS::Exception::BaseException& e) \
803 TEST::exception = 2; \
804 TEST::exception_name = e.getName(); \
806 catch (const std::exception& e) \
808 TEST::exception = 3; \
809 TEST::exception_name = e.what(); \
813 TEST::exception = 4; \
815 TEST::this_test = (TEST::exception == 1); \
816 TEST::test = TEST::test && TEST::this_test; \
818 TEST::initialNewline(); \
819 switch (TEST::exception) \
822 stdcout << " - line " << TEST::test_line << \
823 ": TEST_EXCEPTION(" # exception_type "," # command \
824 "): no exception thrown!\n"; \
825 TEST::failed_lines_list.push_back(TEST::test_line); \
828 if (TEST::verbose > 1) \
830 stdcout << " + line " << TEST::test_line << \
831 ": TEST_EXCEPTION(" # exception_type "," # command \
836 stdcout << " - line " << TEST::test_line << \
837 ": TEST_EXCEPTION(" # exception_type "," # command \
838 "): wrong exception thrown! \"" \
839 << TEST::exception_name << "\"\n"; \
840 TEST::failed_lines_list.push_back(TEST::test_line); \
843 stdcout << " - line " << TEST::test_line << \
844 ": TEST_EXCEPTION(" # exception_type "," # command \
845 "): wrong exception thrown! \"" \
846 << TEST::exception_name << "\"\n"; \
847 TEST::failed_lines_list.push_back(TEST::test_line); \
850 stdcout << " - line " << TEST::test_line << \
851 ": TEST_EXCEPTION(" # exception_type "," # command \
852 "): wrong exception thrown!\n"; \
853 TEST::failed_lines_list.push_back(TEST::test_line); \
870 #ifdef OPENMS_ASSERTIONS
871 #define TEST_PRECONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Precondition, command);
873 #define TEST_PRECONDITION_VIOLATED(command) STATUS("TEST_PRECONDITION_VIOLATED(" # command ") - skipped");
887 #ifdef OPENMS_ASSERTIONS
888 #define TEST_POSTCONDITION_VIOLATED(command) TEST_EXCEPTION(Exception::Postcondition, command);
890 #define TEST_POSTCONDITION_VIOLATED(command) STATUS("TEST_POSTCONDITION_VIOLATED(" # command ") - skipped");
910 #define TEST_EXCEPTION_WITH_MESSAGE(exception_type, command, message) \
912 ++TEST::test_count; \
913 TEST::test_line = __LINE__; \
914 TEST::exception = 0; \
919 catch (exception_type& et) \
921 if (std::string(et.what()) != std::string(message)) \
923 TEST::exception = 4; \
924 TEST::exception_message = et.what(); \
926 else TEST::exception = 1; \
928 catch (::OpenMS::Exception::BaseException& e) \
930 TEST::exception = 2; \
931 TEST::exception_name = e.getName(); \
935 TEST::exception = 3; \
937 TEST::this_test = (TEST::exception == 1); \
938 TEST::test = TEST::test && TEST::this_test; \
941 TEST::initialNewline(); \
942 switch (TEST::exception) \
945 stdcout << " - line " << TEST::test_line << \
946 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
947 "): no exception thrown!\n"; \
948 TEST::failed_lines_list.push_back(TEST::test_line); \
951 if (TEST::verbose > 1) \
954 stdcout << " + line " << TEST::test_line << \
955 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
960 stdcout << " - line " << TEST::test_line << \
961 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
962 "): wrong exception thrown! \"" << \
963 TEST::exception_name << "\"\n"; \
964 TEST::failed_lines_list.push_back(TEST::test_line); \
967 stdcout << " - line " << TEST::test_line << \
968 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
969 "): wrong exception thrown!\n"; \
970 TEST::failed_lines_list.push_back(TEST::test_line); \
973 stdcout << " - line " << TEST::test_line << \
974 ": TEST_EXCEPTION_WITH_MESSAGE(" # exception_type "," # command ", " # message \
975 "): exception has wrong message: got '" << \
976 TEST::exception_message << \
978 (message) << "'\n"; \
979 TEST::failed_lines_list.push_back(TEST::test_line); \
1000 #define NEW_TMP_FILE(filename) \
1002 filename = TEST::tmpFileName(__FILE__, __LINE__); \
1003 TEST::tmp_file_list.push_back(filename); \
1005 TEST::initialNewline(); \
1006 stdcout << " creating new temporary filename '" \
1021 #define ABORT_IF(condition) \
1025 TEST::test_line = __LINE__; \
1026 TEST::this_test = false; \
1027 TEST::test = TEST::test && TEST::this_test; \
1028 TEST::failed_lines_list.push_back(TEST::test_line); \
1029 TEST::initialNewline(); \
1030 stdcout << " - line " << TEST::test_line << \
1031 ": ABORT_IF(" # condition "): TEST ABORTED\n"; \
1053 #define STATUS(message) \
1055 TEST::initialNewline(); \
1056 stdcout << " line " \
1072 #define ADD_MESSAGE(message) \
1073 TEST::add_message = message;
1084 #define NOT_TESTABLE \
1085 TEST::test_count = 1;
#define stdcout
Provide a point of redirection for testing the test macros, see ClassTest_test.cpp.
Definition: ClassTest.h:32
Class to hold strings, numeric values, lists of strings and lists of numeric values.
Definition: DataValue.h:33
Class to hold strings, numeric values, vectors of strings and vectors of numeric values using the stl...
Definition: ParamValue.h:29
int Int
Signed integer type.
Definition: Types.h:76
Namespace for class tests.
Definition: ClassTest.h:41
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:271
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:303
void testFalse(const char *, int line, const bool expression_1, const char *expression_1_stringified)
Definition: ClassTest.h:326
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:351
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:56
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:22