cannam@135: // Copyright (c) 2013-2014 Sandstorm Development Group, Inc. and contributors cannam@135: // Licensed under the MIT License: cannam@135: // cannam@135: // Permission is hereby granted, free of charge, to any person obtaining a copy cannam@135: // of this software and associated documentation files (the "Software"), to deal cannam@135: // in the Software without restriction, including without limitation the rights cannam@135: // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell cannam@135: // copies of the Software, and to permit persons to whom the Software is cannam@135: // furnished to do so, subject to the following conditions: cannam@135: // cannam@135: // The above copyright notice and this permission notice shall be included in cannam@135: // all copies or substantial portions of the Software. cannam@135: // cannam@135: // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR cannam@135: // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, cannam@135: // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE cannam@135: // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER cannam@135: // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, cannam@135: // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN cannam@135: // THE SOFTWARE. cannam@135: cannam@135: #ifndef KJ_TEST_H_ cannam@135: #define KJ_TEST_H_ cannam@135: cannam@135: #if defined(__GNUC__) && !KJ_HEADER_WARNINGS cannam@135: #pragma GCC system_header cannam@135: #endif cannam@135: cannam@135: #include "debug.h" cannam@135: #include "vector.h" cannam@135: cannam@135: namespace kj { cannam@135: cannam@135: class TestRunner; cannam@135: cannam@135: class TestCase { cannam@135: public: cannam@135: TestCase(const char* file, uint line, const char* description); cannam@135: ~TestCase(); cannam@135: cannam@135: virtual void run() = 0; cannam@135: cannam@135: private: cannam@135: const char* file; cannam@135: uint line; cannam@135: const char* description; cannam@135: TestCase* next; cannam@135: TestCase** prev; cannam@135: bool matchedFilter; cannam@135: cannam@135: friend class TestRunner; cannam@135: }; cannam@135: cannam@135: #define KJ_TEST(description) \ cannam@135: /* Make sure the linker fails if tests are not in anonymous namespaces. */ \ cannam@135: extern int KJ_CONCAT(YouMustWrapTestsInAnonymousNamespace, __COUNTER__) KJ_UNUSED; \ cannam@135: class KJ_UNIQUE_NAME(TestCase): public ::kj::TestCase { \ cannam@135: public: \ cannam@135: KJ_UNIQUE_NAME(TestCase)(): ::kj::TestCase(__FILE__, __LINE__, description) {} \ cannam@135: void run() override; \ cannam@135: } KJ_UNIQUE_NAME(testCase); \ cannam@135: void KJ_UNIQUE_NAME(TestCase)::run() cannam@135: cannam@135: #if _MSC_VER cannam@135: #define KJ_INDIRECT_EXPAND(m, vargs) m vargs cannam@135: #define KJ_FAIL_EXPECT(...) \ cannam@135: KJ_INDIRECT_EXPAND(KJ_LOG, (ERROR , __VA_ARGS__)); cannam@135: #define KJ_EXPECT(cond, ...) \ cannam@135: if (cond); else KJ_INDIRECT_EXPAND(KJ_FAIL_EXPECT, ("failed: expected " #cond , __VA_ARGS__)) cannam@135: #else cannam@135: #define KJ_FAIL_EXPECT(...) \ cannam@135: KJ_LOG(ERROR, ##__VA_ARGS__); cannam@135: #define KJ_EXPECT(cond, ...) \ cannam@135: if (cond); else KJ_FAIL_EXPECT("failed: expected " #cond, ##__VA_ARGS__) cannam@135: #endif cannam@135: cannam@135: #define KJ_EXPECT_THROW(type, code) \ cannam@135: do { \ cannam@135: KJ_IF_MAYBE(e, ::kj::runCatchingExceptions([&]() { code; })) { \ cannam@135: KJ_EXPECT(e->getType() == ::kj::Exception::Type::type, \ cannam@135: "code threw wrong exception type: " #code, e->getType()); \ cannam@135: } else { \ cannam@135: KJ_FAIL_EXPECT("code did not throw: " #code); \ cannam@135: } \ cannam@135: } while (false) cannam@135: cannam@135: #define KJ_EXPECT_THROW_MESSAGE(message, code) \ cannam@135: do { \ cannam@135: KJ_IF_MAYBE(e, ::kj::runCatchingExceptions([&]() { code; })) { \ cannam@135: KJ_EXPECT(::kj::_::hasSubstring(e->getDescription(), message), \ cannam@135: "exception description didn't contain expected substring", e->getDescription()); \ cannam@135: } else { \ cannam@135: KJ_FAIL_EXPECT("code did not throw: " #code); \ cannam@135: } \ cannam@135: } while (false) cannam@135: cannam@135: #define KJ_EXPECT_LOG(level, substring) \ cannam@135: ::kj::_::LogExpectation KJ_UNIQUE_NAME(_kjLogExpectation)(::kj::LogSeverity::level, substring) cannam@135: // Expects that a log message with the given level and substring text will be printed within cannam@135: // the current scope. This message will not cause the test to fail, even if it is an error. cannam@135: cannam@135: // ======================================================================================= cannam@135: cannam@135: namespace _ { // private cannam@135: cannam@135: bool hasSubstring(kj::StringPtr haystack, kj::StringPtr needle); cannam@135: cannam@135: class LogExpectation: public ExceptionCallback { cannam@135: public: cannam@135: LogExpectation(LogSeverity severity, StringPtr substring); cannam@135: ~LogExpectation(); cannam@135: cannam@135: void logMessage(LogSeverity severity, const char* file, int line, int contextDepth, cannam@135: String&& text) override; cannam@135: cannam@135: private: cannam@135: LogSeverity severity; cannam@135: StringPtr substring; cannam@135: bool seen; cannam@135: UnwindDetector unwindDetector; cannam@135: }; cannam@135: cannam@135: class GlobFilter { cannam@135: // Implements glob filters for the --filter flag. cannam@135: // cannam@135: // Exposed in header only for testing. cannam@135: cannam@135: public: cannam@135: explicit GlobFilter(const char* pattern); cannam@135: explicit GlobFilter(ArrayPtr pattern); cannam@135: cannam@135: bool matches(StringPtr name); cannam@135: cannam@135: private: cannam@135: String pattern; cannam@135: Vector states; cannam@135: cannam@135: void applyState(char c, int state); cannam@135: }; cannam@135: cannam@135: } // namespace _ (private) cannam@135: } // namespace kj cannam@135: cannam@135: #endif // KJ_TEST_H_