// Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // #pragma once #include #include #include #include #include #include #include namespace beast::unit_test { namespace detail { template static std::string makeReason(String const& reason, char const* file, int line) { std::string s(reason); if (!s.empty()) s.append(": "); namespace fs = boost::filesystem; s.append(fs::path{file}.filename().string()); s.append("("); s.append(boost::lexical_cast(line)); s.append(")"); return s; } } // namespace detail class Thread; enum class AbortT { NoAbortOnFail, AbortOnFail }; /** A testsuite class. Derived classes execute a series of testcases, where each testcase is a series of pass/fail tests. To provide a unit test using this class, derive from it and use the BEAST_DEFINE_UNIT_TEST macro in a translation unit. */ class Suite { private: bool abort_ = false; bool aborted_ = false; Runner* runner_ = nullptr; // This exception is thrown internally to stop the current suite // in the event of a failure, if the option to stop is set. struct AbortException : public std::exception { [[nodiscard]] char const* what() const noexcept override { return "test suite aborted"; } }; template class LogBuf : public std::basic_stringbuf { Suite& suite_; public: explicit LogBuf(Suite& self) : suite_(self) { } ~LogBuf() override { sync(); } int sync() override { auto const& s = this->str(); if (s.size() > 0) suite_.runner_->log(s); this->str(""); return 0; } }; template < class CharT, class Traits = std::char_traits, class Allocator = std::allocator> class LogOs : public std::basic_ostream { LogBuf buf_; public: explicit LogOs(Suite& self) : std::basic_ostream(&buf_), buf_(self) { } }; class ScopedTestcase; class TestcaseT { Suite& suite_; std::stringstream ss_; public: explicit TestcaseT(Suite& self) : suite_(self) { } /** Open a new testcase. A testcase is a series of evaluated test conditions. A test suite may have multiple test cases. A test is associated with the last opened testcase. When the test first runs, a default unnamed case is opened. Tests with only one case may omit the call to testcase. @param abort Determines if suite continues running after a failure. */ void operator()(std::string const& name, AbortT abort = AbortT::NoAbortOnFail); ScopedTestcase operator()(AbortT abort); template ScopedTestcase operator<<(T const& t); }; public: /** Logging output stream. Text sent to the log output stream will be forwarded to the output stream associated with the runner. */ LogOs log; /** Memberspace for declaring test cases. */ TestcaseT testcase; /** Returns the "current" running suite. If no suite is running, nullptr is returned. */ static Suite* thisSuite() { return *pThisSuite(); } Suite() : log(*this), testcase(*this) { } virtual ~Suite() = default; Suite(Suite const&) = delete; Suite& operator=(Suite const&) = delete; /** Invokes the test using the specified runner. Data members are set up here instead of the constructor as a convenience to writing the derived class to avoid repetition of forwarded constructor arguments to the base. Normally this is called by the framework for you. */ template void operator()(Runner& r); /** Record a successful test condition. */ template void pass(); /** Record a failure. @param reason Optional text added to the output on a failure. @param file The source code file where the test failed. @param line The source code line number where the test failed. */ /** @{ */ template void fail(String const& reason, char const* file, int line); template void fail(std::string const& reason = ""); /** @} */ /** Evaluate a test condition. This function provides improved logging by incorporating the file name and line number into the reported output on failure, as well as additional text specified by the caller. @param shouldBeTrue The condition to test. The condition is evaluated in a boolean context. @param reason Optional added text to output on a failure. @param file The source code file where the test failed. @param line The source code line number where the test failed. @return `true` if the test condition indicates success. */ /** @{ */ template bool expect(Condition const& shouldBeTrue) { return expect(shouldBeTrue, ""); } template bool expect(Condition const& shouldBeTrue, String const& reason); template bool expect(Condition const& shouldBeTrue, char const* file, int line) { return expect(shouldBeTrue, "", file, line); } template bool expect(Condition const& shouldBeTrue, String const& reason, char const* file, int line); /** @} */ // // DEPRECATED // // Expect an exception from f() template bool except(F&& f, String const& reason); template bool except(F&& f) { return except(f, ""); } template bool except(F&& f, String const& reason); template bool except(F&& f) { return except(f, ""); } template bool unexcept(F&& f, String const& reason); template bool unexcept(F&& f) { return unexcept(f, ""); } /** Return the argument associated with the runner. */ std::string const& arg() const { return runner_->arg(); } // DEPRECATED // @return `true` if the test condition indicates success(a false value) template bool unexpected(Condition shouldBeFalse, String const& reason); template bool unexpected(Condition shouldBeFalse) { return unexpected(shouldBeFalse, ""); } private: friend class Thread; static Suite** pThisSuite() { static Suite* kPTs = nullptr; // NOLINT TODO return &kPTs; } /** Runs the suite. */ virtual void run() = 0; void propagateAbort() const; template void run(Runner& r); }; //------------------------------------------------------------------------------ // Helper for streaming testcase names class Suite::ScopedTestcase { private: Suite& suite_; std::stringstream& ss_; public: ScopedTestcase& operator=(ScopedTestcase const&) = delete; ~ScopedTestcase() { auto const& name = ss_.str(); if (!name.empty()) suite_.runner_->testcase(name); } ScopedTestcase(Suite& self, std::stringstream& ss) : suite_(self), ss_(ss) { ss_.clear(); ss_.str({}); } template ScopedTestcase(Suite& self, std::stringstream& ss, T const& t) : suite_(self), ss_(ss) { ss_.clear(); ss_.str({}); ss_ << t; } template ScopedTestcase& operator<<(T const& t) { ss_ << t; return *this; } }; //------------------------------------------------------------------------------ inline void Suite::TestcaseT::operator()(std::string const& name, AbortT abort) { suite_.abort_ = abort == AbortT::AbortOnFail; suite_.runner_->testcase(name); } inline Suite::ScopedTestcase Suite::TestcaseT::operator()(AbortT abort) { suite_.abort_ = abort == AbortT::AbortOnFail; return {suite_, ss_}; } template inline Suite::ScopedTestcase Suite::TestcaseT::operator<<(T const& t) { return {suite_, ss_, t}; } //------------------------------------------------------------------------------ template void Suite::operator()(Runner& r) { *pThisSuite() = this; try { run(r); *pThisSuite() = nullptr; } catch (...) { *pThisSuite() = nullptr; throw; } } template bool Suite::expect(Condition const& shouldBeTrue, String const& reason) { if (shouldBeTrue) { pass(); return true; } fail(reason); return false; } template bool Suite::expect(Condition const& shouldBeTrue, String const& reason, char const* file, int line) { if (shouldBeTrue) { pass(); return true; } fail(detail::makeReason(reason, file, line)); return false; } // DEPRECATED template bool Suite::except(F&& f, String const& reason) { try { f(); fail(reason); return false; } catch (...) { pass(); } return true; } template bool Suite::except(F&& f, String const& reason) { try { f(); fail(reason); return false; } catch (E const&) { pass(); } return true; } template bool Suite::unexcept(F&& f, String const& reason) { try { f(); pass(); return true; } catch (...) { fail(reason); } return false; } template bool Suite::unexpected(Condition shouldBeFalse, String const& reason) { bool const b = static_cast(shouldBeFalse); if (!b) { pass(); } else { fail(reason); } return !b; } template void Suite::pass() { propagateAbort(); runner_->pass(); } // ::fail template void Suite::fail(std::string const& reason) { propagateAbort(); runner_->fail(reason); if (abort_) { aborted_ = true; BOOST_THROW_EXCEPTION(AbortException()); } } template void Suite::fail(String const& reason, char const* file, int line) { fail(detail::makeReason(reason, file, line)); } inline void Suite::propagateAbort() const { if (abort_ && aborted_) BOOST_THROW_EXCEPTION(AbortException()); } template void Suite::run(Runner& r) { runner_ = &r; try { run(); } catch (AbortException const&) // NOLINT(bugprone-empty-catch) { // ends the suite } catch (std::exception const& e) { runner_->fail("unhandled exception: " + std::string(e.what())); } catch (...) { runner_->fail("unhandled exception"); } } #ifndef BEAST_EXPECT /** Check a precondition. If the condition is false, the file and line number are reported. */ #define BEAST_EXPECT(cond) expect(cond, __FILE__, __LINE__) #endif #ifndef BEAST_EXPECTS /** Check a precondition. If the condition is false, the file and line number are reported. */ #define BEAST_EXPECTS(cond, reason) \ ((cond) ? (pass(), true) : (fail((reason), __FILE__, __LINE__), false)) #endif } // namespace beast::unit_test //------------------------------------------------------------------------------ // detail: // This inserts the suite with the given manual flag #define BEAST_DEFINE_TESTSUITE_INSERT(Class, Module, Library, manual, priority) \ static beast::unit_test::detail::InsertSuite \ Library##Module##Class##_test_instance(#Class, #Module, #Library, manual, priority) //------------------------------------------------------------------------------ // Preprocessor directives for controlling unit test definitions. // If this is already defined, don't redefine it. This allows // programs to provide custom behavior for testsuite definitions // #ifndef BEAST_DEFINE_TESTSUITE /** Enables insertion of test suites into the global container. The default is to insert all test suite definitions into the global container. If BEAST_DEFINE_TESTSUITE is user defined, this macro has no effect. */ #ifndef BEAST_NO_UNIT_TEST_INLINE #define BEAST_NO_UNIT_TEST_INLINE 0 #endif /** Define a unit test suite. Class The type representing the class being tested. Module Identifies the module. Library Identifies the library. The declaration for the class implementing the test should be the same as Class ## _test. For example, if Class is aged_ordered_container, the test class must be declared as: @code struct aged_ordered_container_test : beast::unit_test::suite { //... }; @endcode The macro invocation must appear in the same namespace as the test class. Unit test priorities were introduced so parallel unit_test::suites would execute faster. Suites with longer running times have higher priorities than unit tests with shorter running times. Suites with no priorities are assumed to run most quickly, so they run last. */ #if BEAST_NO_UNIT_TEST_INLINE #define BEAST_DEFINE_TESTSUITE(Class, Module, Library) #define BEAST_DEFINE_TESTSUITE_MANUAL(Class, Module, Library) #define BEAST_DEFINE_TESTSUITE_PRIO(Class, Module, Library, Priority) #define BEAST_DEFINE_TESTSUITE_MANUAL_PRIO(Class, Module, Library, Priority) #else #include #define BEAST_DEFINE_TESTSUITE(Class, Module, Library) \ BEAST_DEFINE_TESTSUITE_INSERT(Class, Module, Library, false, 0) #define BEAST_DEFINE_TESTSUITE_MANUAL(Class, Module, Library) \ BEAST_DEFINE_TESTSUITE_INSERT(Class, Module, Library, true, 0) #define BEAST_DEFINE_TESTSUITE_PRIO(Class, Module, Library, Priority) \ BEAST_DEFINE_TESTSUITE_INSERT(Class, Module, Library, false, Priority) #define BEAST_DEFINE_TESTSUITE_MANUAL_PRIO(Class, Module, Library, Priority) \ BEAST_DEFINE_TESTSUITE_INSERT(Class, Module, Library, true, Priority) #endif #endif //------------------------------------------------------------------------------