/* * catch_capture.hpp * Catch * * Created by Phil on 18/10/2010. * Copyright 2010 Two Blue Cubes Ltd. All rights reserved. * * 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) * */ #ifndef TWOBLUECUBES_CATCH_CAPTURE_HPP_INCLUDED #define TWOBLUECUBES_CATCH_CAPTURE_HPP_INCLUDED #include "catch_resultinfo.hpp" #include "catch_result_type.h" #include "catch_interfaces_capture.h" #include "catch_debugger.hpp" #include "catch_evaluate.hpp" #include #include namespace Catch { namespace Detail { // The following code, contributed by Sam Partington, allows us to choose an implementation // of toString() depending on whether a << overload is available struct NonStreamable { // allow construction from anything... template NonStreamable(Anything) {} }; // a local operator<< which may be called if there isn't a better one elsewhere... inline NonStreamable operator << ( std::ostream&, const NonStreamable& ns ) { return ns; } template struct IsStreamable { static NoType Deduce( const NonStreamable& ); static YesType Deduce( std::ostream& ); enum { value = sizeof( Deduce( Synth() << Synth() ) ) == sizeof( YesType ) }; }; // << is available, so use it with ostringstream to make the string template struct StringMaker { /////////////////////////////////////////////////////////////////////// static std::string apply ( const T& value ) { std::ostringstream oss; oss << value; return oss.str(); } }; // << not available - use a default string template struct StringMaker { /////////////////////////////////////////////////////////////////////// static std::string apply ( const T& ) { return "{?}"; } }; }// end namespace Detail /////////////////////////////////////////////////////////////////////////////// template std::string toString ( const T& value ) { return Detail::StringMaker::value>::apply( value ); } // Shortcut overloads /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( const std::string& value ) { return "\"" + value + "\""; } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( const std::wstring& value ) { std::ostringstream oss; oss << "\""; for(size_t i = 0; i < value.size(); ++i ) oss << static_cast( value[i] <= 0xff ? value[i] : '?'); oss << "\""; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( const char* const value ) { return value ? Catch::toString( std::string( value ) ) : std::string( "{null string}" ); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( char* const value ) { return Catch::toString( static_cast( value ) ); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( int value ) { std::ostringstream oss; oss << value; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( unsigned int value ) { std::ostringstream oss; if( value > 8192 ) oss << "0x" << std::hex << value; else oss << value; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( unsigned long value ) { std::ostringstream oss; if( value > 8192 ) oss << "0x" << std::hex << value; else oss << value; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( const double value ) { std::ostringstream oss; oss << value; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( bool value ) { return value ? "true" : "false"; } /////////////////////////////////////////////////////////////////////////////// inline std::string toString ( void* p ) { if( !p ) return INTERNAL_CATCH_STRINGIFY( NULL ); std::ostringstream oss; oss << p; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// template inline std::string toString ( T* p ) { return Catch::toString( static_cast( p ) ); } /////////////////////////////////////////////////////////////////////////////// template inline std::string toString ( const T* p ) { return Catch::toString( static_cast( const_cast( p ) ) ); } struct TestFailureException { }; struct DummyExceptionType_DontUse { }; struct STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison; class MutableResultInfo : public ResultInfo { public: /////////////////////////////////////////////////////////////////////////// MutableResultInfo () {} /////////////////////////////////////////////////////////////////////////// MutableResultInfo ( const char* expr, bool isNot, const char* filename, std::size_t line, const char* macroName, const char* message = "" ) : ResultInfo( expr, ResultWas::Unknown, isNot, filename, line, macroName, message ) { } /////////////////////////////////////////////////////////////////////////// void setResultType ( ResultWas::OfType result ) { // Flip bool results if isNot is set if( m_isNot && result == ResultWas::Ok ) m_result = ResultWas::ExpressionFailed; else if( m_isNot && result == ResultWas::ExpressionFailed ) m_result = ResultWas::Ok; else m_result = result; } /////////////////////////////////////////////////////////////////////////// void setMessage ( const std::string& message ) { m_message = message; } /////////////////////////////////////////////////////////////////////////// void setFileAndLine ( const std::string& filename, std::size_t line ) { m_filename = filename; m_line = line; } /////////////////////////////////////////////////////////////////////////// template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator || ( const RhsT& ); /////////////////////////////////////////////////////////////////////////// template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator && ( const RhsT& ); private: friend class ResultBuilder; template friend class Expression; template friend class PtrExpression; /////////////////////////////////////////////////////////////////////////// MutableResultInfo& captureBoolExpression ( bool result ) { m_lhs = Catch::toString( result ); m_op = m_isNot ? "!" : ""; setResultType( result ? ResultWas::Ok : ResultWas::ExpressionFailed ); return *this; } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& captureExpression ( const T1& lhs, const T2& rhs ) { setResultType( Internal::compare( lhs, rhs ) ? ResultWas::Ok : ResultWas::ExpressionFailed ); m_lhs = Catch::toString( lhs ); m_rhs = Catch::toString( rhs ); m_op = Internal::OperatorTraits::getName(); return *this; } }; template class Expression { void operator = ( const Expression& ); public: /////////////////////////////////////////////////////////////////////////// Expression ( MutableResultInfo& result, const T& lhs ) : m_result( result ), m_lhs( lhs ) { } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator == ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator != ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator < ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator > ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator <= ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator >= ( const RhsT& rhs ) { return m_result.captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// operator MutableResultInfo& () { return m_result.captureBoolExpression( m_lhs ); } /////////////////////////////////////////////////////////////////////////// template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator + ( const RhsT& ); /////////////////////////////////////////////////////////////////////////// template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator - ( const RhsT& ); private: MutableResultInfo& m_result; const T& m_lhs; }; template class PtrExpression { public: /////////////////////////////////////////////////////////////////////////// PtrExpression ( MutableResultInfo& result, const LhsT* lhs ) : m_result( &result ), m_lhs( lhs ) {} /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator == ( const RhsT* rhs ) { return m_result->captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// // This catches NULL MutableResultInfo& operator == ( LhsT* rhs ) { return m_result->captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// template MutableResultInfo& operator != ( const RhsT* rhs ) { return m_result->captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// // This catches NULL MutableResultInfo& operator != ( LhsT* rhs ) { return m_result->captureExpression( m_lhs, rhs ); } /////////////////////////////////////////////////////////////////////////// operator MutableResultInfo& () { return m_result->captureBoolExpression( m_lhs ); } private: MutableResultInfo* m_result; const LhsT* m_lhs; }; class ResultBuilder { public: /////////////////////////////////////////////////////////////////////////// ResultBuilder ( const char* filename, std::size_t line, const char* macroName, const char* expr = "", bool isNot = false ) : m_result( expr, isNot, filename, line, macroName ) {} /////////////////////////////////////////////////////////////////////////// template Expression operator->* ( const T & operand ) { Expression expr( m_result, operand ); return expr; } /////////////////////////////////////////////////////////////////////////// template PtrExpression operator->* ( const T* operand ) { PtrExpression expr( m_result, operand ); return expr; } /////////////////////////////////////////////////////////////////////////// template PtrExpression operator->* ( T* operand ) { PtrExpression expr( m_result, operand ); return expr; } /////////////////////////////////////////////////////////////////////////// template ResultBuilder& operator << ( const T & value ) { m_messageStream << value; return *this; } /////////////////////////////////////////////////////////////////////////// ResultBuilder& setResultType ( ResultWas::OfType resultType ) { m_result.setResultType( resultType ); return *this; } /////////////////////////////////////////////////////////////////////////// operator MutableResultInfo& () { m_result.setMessage( m_messageStream.str() ); return m_result; } private: MutableResultInfo m_result; std::ostringstream m_messageStream; }; class ScopedInfo { public: /////////////////////////////////////////////////////////////////////////// ScopedInfo () { Hub::getResultCapture().pushScopedInfo( this ); } /////////////////////////////////////////////////////////////////////////// ~ScopedInfo () { Hub::getResultCapture().popScopedInfo( this ); } /////////////////////////////////////////////////////////////////////////// ScopedInfo& operator << ( const char* str ) { m_oss << str; return *this; } /////////////////////////////////////////////////////////////////////////// std::string getInfo () const { return m_oss.str(); } private: std::ostringstream m_oss; }; // !TBD Need to clean this all up #define CATCH_absTol 1e-10 #define CATCH_relTol 1e-10 inline double catch_max( double x, double y ) { return x > y ? x : y; } namespace Detail { class Approx { public: /////////////////////////////////////////////////////////////////////////// // !TBD more generic explicit Approx ( double d ) : m_d( d ) { } /////////////////////////////////////////////////////////////////////////// template friend bool operator == ( const T& lhs, const Approx& rhs ) { // !TBD Use proper tolerance // From: http://realtimecollisiondetection.net/blog/?p=89 // see also: http://www.cygnus-software.com/papers/comparingfloats/comparingfloats.htm return fabs( lhs - rhs.m_d ) <= catch_max( CATCH_absTol, CATCH_relTol * catch_max( fabs(lhs), fabs(rhs.m_d) ) ); } /////////////////////////////////////////////////////////////////////////// template friend bool operator != ( const T& lhs, const Approx& rhs ) { return ! operator==( lhs, rhs ); } double m_d; }; } /////////////////////////////////////////////////////////////////////////////// template<> inline std::string toString ( const Detail::Approx& value ) { std::ostringstream oss; oss << "Approx( " << value.m_d << ")"; return oss.str(); } /////////////////////////////////////////////////////////////////////////////// // This is just here to avoid compiler warnings with macro constants inline bool isTrue ( bool value ) { return value; } } // end namespace Catch /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_ACCEPT_EXPR( expr, stopOnFailure ) \ if( Catch::ResultAction::Value action = Catch::Hub::getResultCapture().acceptExpression( expr ) ) \ { \ if( action == Catch::ResultAction::DebugFailed ) BreakIntoDebugger(); \ if( Catch::isTrue( stopOnFailure ) ) throw Catch::TestFailureException(); \ } /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_TEST( expr, isNot, stopOnFailure, macroName ) \ INTERNAL_CATCH_ACCEPT_EXPR( ( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr, isNot )->*expr ), stopOnFailure ); \ if( Catch::isTrue( false ) ){ bool dummyResult = ( expr ); Catch::isTrue( dummyResult ); } /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_NO_THROW( expr, stopOnFailure, macroName ) \ try \ { \ expr; \ INTERNAL_CATCH_ACCEPT_EXPR( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ).setResultType( Catch::ResultWas::Ok ), stopOnFailure ); \ } \ catch( std::exception& ex ) \ { \ INTERNAL_CATCH_ACCEPT_EXPR( ( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ) << ex.what() ).setResultType( Catch::ResultWas::ThrewException ), stopOnFailure ); \ } \ catch( ... ) \ { \ INTERNAL_CATCH_ACCEPT_EXPR( ( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ) << Catch::Hub::getExceptionTranslatorRegistry().translateActiveException() ).setResultType( Catch::ResultWas::ThrewException ), stopOnFailure ); \ } /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_THROWS( expr, exceptionType, stopOnFailure, macroName ) \ try \ { \ expr; \ INTERNAL_CATCH_ACCEPT_EXPR( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ).setResultType( Catch::ResultWas::DidntThrowException ), stopOnFailure ); \ } \ catch( Catch::TestFailureException& ) \ { \ throw; \ } \ catch( exceptionType ) \ { \ INTERNAL_CATCH_ACCEPT_EXPR( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ).setResultType( Catch::ResultWas::Ok ), stopOnFailure ); \ } /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_THROWS_AS( expr, exceptionType, stopOnFailure, macroName ) \ INTERNAL_CATCH_THROWS( expr, exceptionType, stopOnFailure, macroName ) \ catch( ... ) \ { \ INTERNAL_CATCH_ACCEPT_EXPR( ( Catch::ResultBuilder( __FILE__, __LINE__, macroName, #expr ) << Catch::Hub::getExceptionTranslatorRegistry().translateActiveException() ).setResultType( Catch::ResultWas::ThrewException ), stopOnFailure ); \ } /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_MSG( reason, resultType, stopOnFailure, macroName ) \ Catch::Hub::getResultCapture().acceptExpression( ( Catch::ResultBuilder( __FILE__, __LINE__, macroName ) << reason ).setResultType( resultType ) ); /////////////////////////////////////////////////////////////////////////////// #define INTERNAL_CATCH_SCOPED_INFO( log ) \ Catch::ScopedInfo INTERNAL_CATCH_UNIQUE_NAME( info ); \ INTERNAL_CATCH_UNIQUE_NAME( info ) << log #endif // TWOBLUECUBES_CATCH_CAPTURE_HPP_INCLUDED