catch2/projects/SelfTest/ExceptionTests.cpp

227 lines
5.8 KiB
C++
Raw Permalink Normal View History

2010-11-10 00:24:00 +01:00
/*
* Created by Phil on 09/11/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)
*/
2011-04-26 09:32:40 +02:00
#include "catch.hpp"
2010-11-10 00:24:00 +01:00
#include <string>
2011-01-07 11:22:24 +01:00
#include <stdexcept>
2010-11-10 00:24:00 +01:00
#ifdef _MSC_VER
#pragma warning(disable:4702) // Unreachable code -- MSVC 19 (VS 2015) sees right through the indirection
#endif
2010-11-10 00:24:00 +01:00
namespace
{
inline int thisThrows()
2010-11-10 00:24:00 +01:00
{
if( Catch::alwaysTrue() )
throw std::domain_error( "expected exception" );
return 1;
2010-11-10 00:24:00 +01:00
}
int thisDoesntThrow()
{
return 0;
}
}
TEST_CASE( "When checked exceptions are thrown they can be expected or unexpected", "[!throws]" )
2010-11-10 00:24:00 +01:00
{
REQUIRE_THROWS_AS( thisThrows(), std::domain_error );
REQUIRE_NOTHROW( thisDoesntThrow() );
REQUIRE_THROWS( thisThrows() );
2010-11-10 00:24:00 +01:00
}
TEST_CASE( "Expected exceptions that don't throw or unexpected exceptions fail the test", "[.][failing][!throws]" )
2010-11-10 00:24:00 +01:00
{
CHECK_THROWS_AS( thisThrows(), std::string );
CHECK_THROWS_AS( thisDoesntThrow(), std::domain_error );
CHECK_NOTHROW( thisThrows() );
}
TEST_CASE( "When unchecked exceptions are thrown directly they are always failures", "[.][failing][!throws]" )
2010-11-10 00:24:00 +01:00
{
if( Catch::alwaysTrue() )
throw std::domain_error( "unexpected exception" );
2010-11-10 00:24:00 +01:00
}
TEST_CASE( "An unchecked exception reports the line of the last assertion", "[.][failing][!throws]" )
{
CHECK( 1 == 1 );
if( Catch::alwaysTrue() )
throw std::domain_error( "unexpected exception" );
}
TEST_CASE( "When unchecked exceptions are thrown from sections they are always failures", "[.][failing][!throws]" )
{
SECTION( "section name", "" )
{
if( Catch::alwaysTrue() )
throw std::domain_error( "unexpected exception" );
}
}
TEST_CASE( "When unchecked exceptions are thrown from functions they are always failures", "[.][failing][!throws]" )
{
CHECK( thisThrows() == 0 );
}
TEST_CASE( "When unchecked exceptions are thrown during a REQUIRE the test should abort fail", "[.][failing][!throws]" )
{
REQUIRE( thisThrows() == 0 );
FAIL( "This should never happen" );
}
2017-01-24 10:53:04 +01:00
TEST_CASE( "When unchecked exceptions are thrown during a CHECK the test should continue", "[.][failing][!throws]" )
{
try {
CHECK(thisThrows() == 0);
}
catch(...) {
FAIL( "This should never happen" );
}
}
TEST_CASE( "When unchecked exceptions are thrown, but caught, they do not affect the test", "[!throws]" )
2010-11-10 00:24:00 +01:00
{
try
{
throw std::domain_error( "unexpected exception" );
}
catch(...)
{
}
}
2011-04-20 16:40:40 +02:00
class CustomException
{
public:
CustomException( const std::string& msg )
: m_msg( msg )
{}
2011-04-20 16:40:40 +02:00
std::string getMessage() const
{
return m_msg;
}
2011-04-20 16:40:40 +02:00
private:
std::string m_msg;
};
class CustomStdException : public std::exception
{
public:
CustomStdException( const std::string& msg )
: m_msg( msg )
{}
~CustomStdException() CATCH_NOEXCEPT {}
2015-12-04 11:20:33 +01:00
std::string getMessage() const
{
return m_msg;
}
2015-12-04 11:20:33 +01:00
private:
std::string m_msg;
};
2011-04-20 20:09:41 +02:00
CATCH_TRANSLATE_EXCEPTION( CustomException& ex )
2011-04-20 16:40:40 +02:00
{
2011-04-20 20:09:41 +02:00
return ex.getMessage();
}
2011-04-20 16:40:40 +02:00
CATCH_TRANSLATE_EXCEPTION( CustomStdException& ex )
{
return ex.getMessage();
}
2011-04-20 20:09:41 +02:00
CATCH_TRANSLATE_EXCEPTION( double& ex )
{
return Catch::toString( ex );
2011-04-20 16:40:40 +02:00
}
TEST_CASE("Non-std exceptions can be translated", "[.][failing][!throws]" )
2011-04-20 16:40:40 +02:00
{
if( Catch::alwaysTrue() )
throw CustomException( "custom exception" );
}
TEST_CASE("Custom std-exceptions can be custom translated", "[.][failing][!throws]" )
{
if( Catch::alwaysTrue() )
throw CustomException( "custom std exception" );
}
inline void throwCustom() {
if( Catch::alwaysTrue() )
throw CustomException( "custom exception - not std" );
2011-04-20 16:40:40 +02:00
}
2011-04-20 20:09:41 +02:00
TEST_CASE( "Custom exceptions can be translated when testing for nothrow", "[.][failing][!throws]" )
2011-04-20 20:09:41 +02:00
{
REQUIRE_NOTHROW( throwCustom() );
2011-04-20 20:09:41 +02:00
}
TEST_CASE( "Custom exceptions can be translated when testing for throwing as something else", "[.][failing][!throws]" )
2011-04-20 20:09:41 +02:00
{
REQUIRE_THROWS_AS( throwCustom(), std::exception );
2011-04-20 20:09:41 +02:00
}
TEST_CASE( "Unexpected exceptions can be translated", "[.][failing][!throws]" )
2011-04-20 20:09:41 +02:00
{
if( Catch::alwaysTrue() )
throw double( 3.14 );
2011-04-20 20:09:41 +02:00
}
2012-07-05 19:37:58 +02:00
inline int thisFunctionNotImplemented( int ) {
CATCH_NOT_IMPLEMENTED;
}
TEST_CASE( "NotImplemented exception", "[!throws]" )
2012-07-05 19:37:58 +02:00
{
REQUIRE_THROWS( thisFunctionNotImplemented( 7 ) );
}
TEST_CASE( "Exception messages can be tested for", "[!throws]" ) {
using namespace Catch::Matchers;
SECTION( "exact match" )
REQUIRE_THROWS_WITH( thisThrows(), "expected exception" );
SECTION( "different case" )
REQUIRE_THROWS_WITH( thisThrows(), Equals( "expecteD Exception", Catch::CaseSensitive::No ) );
SECTION( "wildcarded" ) {
REQUIRE_THROWS_WITH( thisThrows(), StartsWith( "expected" ) );
REQUIRE_THROWS_WITH( thisThrows(), EndsWith( "exception" ) );
REQUIRE_THROWS_WITH( thisThrows(), Contains( "except" ) );
REQUIRE_THROWS_WITH( thisThrows(), Contains( "exCept", Catch::CaseSensitive::No ) );
}
}
TEST_CASE( "Mismatching exception messages failing the test", "[.][failing][!throws]" ) {
REQUIRE_THROWS_WITH( thisThrows(), "expected exception" );
REQUIRE_THROWS_WITH( thisThrows(), "should fail" );
REQUIRE_THROWS_WITH( thisThrows(), "expected exception" );
}
TEST_CASE( "#748 - captures with unexpected exceptions", "[!shouldfail][!throws]" ) {
int answer = 42;
CAPTURE( answer );
// the message should be printed on the first two sections but not on the third
SECTION( "outside assertions" ) {
thisThrows();
}
SECTION( "inside REQUIRE_NOTHROW" ) {
REQUIRE_NOTHROW( thisThrows() );
}
SECTION( "inside REQUIRE_THROWS" ) {
REQUIRE_THROWS( thisThrows() );
}
}