TDD(단위 테스트) - CppUnit 1.12.1

CppUnit 모듈 설치

1. 여기서 CppUnit 소스 모듈(cppunit-1.12.1.tar.gz)을 다운 받는다.

2. 압축을 풀어서 컴파일한다.

$CPPUNIT/src/CppUnitLibraries.dsw

cppunit 서브 프로젝트를 빌드한다. // cppunitd.lib, cppunit.lib

사용할 때(콘솔 어플리케이션인 경우)

'코드 제네레이션' 설정을 Multithreaded DLL로 한다.

[Project Settings | All Configurations | C/C++ | C++ langage]

'Enable Run-Time Type Information (RTTI)' 을 체크한다.

프로젝트가 다음의 위치를 참조할 수 있도록 한다.

$CPPUNIT/include/
$CPPUNIT/lib/
($CPPUNIT/src/cppunit/)

cppunitd.lib(cppunit.lib)을 링크한다.

[Project Settings | All Configurations | post-build step]

Post-build description: 'Unit testing...'
Post-build command(s): '$(TargetPath)'

CppUnit::TestFixture

on setUp
on tearDown

CppUnit::TextUi::TestRunner

.addTest()
.run()

CPPUNIT_TEST_SUITE()
CPPUNIT_TEST()
CPPUNIT_TEST_EXCEPTION()
CPPUNIT_TEST_SUITE_END()

CPPUNIT_TEST_SUITE_REGISTRATION()

CPPUNIT_FAIL()
CPPUNIT_ASSERT_EQUAL()
CPPUNIT_ASSERT()

1. 사용하는 사람의 입장에서 가상의 개체에 대한 테스트 코드를 작성한다.

#if !defined(AFX_MONEYTEST_H__17584F8B_6242_4BA0_BF75_C291D95D8CD4__INCLUDED_)
#define AFX_MONEYTEST_H__17584F8B_6242_4BA0_BF75_C291D95D8CD4__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include <cppunit/extensions/HelperMacros.h>

#include "Money.h"

class MoneyTest : public CppUnit::TestFixture  
{
    CPPUNIT_TEST_SUITE(MoneyTest);    ///< declares that our Fiture's test suite
    CPPUNIT_TEST(testConstructor);    ///< adds a test to our test suite. The test is implemented by a method named testConstructor()
    CPPUNIT_TEST( testEqual );
   CPPUNIT_TEST( testAdd );
    CPPUNIT_TEST_EXCEPTION( testAddThrow, IncompatibleMoneyError );
    CPPUNIT_TEST_SUITE_END();
public:
    MoneyTest();
    virtual ~MoneyTest();

    void setUp();        ///< setUp some fixtures
    void tearDown();    ///< tearDown some fixtures

    void testConstructor();
    void testEqual();
    void testAdd();
    void testAddThrow();
};

#endif // !defined(AFX_MONEYTEST_H__17584F8B_6242_4BA0_BF75_C291D95D8CD4__INCLUDED_)

#include "MoneyTest.h"

/// Registers the fixture into the 'registry'
CPPUNIT_TEST_SUITE_REGISTRATION(MoneyTest);

//////////////////////////////////////////////////////////////////////
// Construction/Destruction
//////////////////////////////////////////////////////////////////////

MoneyTest::MoneyTest()
{

}

MoneyTest::~MoneyTest()
{

}

void MoneyTest::setUp()
{ }

void MoneyTest::tearDown()
{ }

void MoneyTest::testConstructor()
{
  // Set up
  const std::string currencyFF( "FF" );
  const double longNumber = 12345678.90123;

  // Process
  Money money( longNumber, currencyFF );

  // Check
  CPPUNIT_ASSERT_EQUAL( longNumber, money.getAmount() );
  CPPUNIT_ASSERT_EQUAL( currencyFF, money.getCurrency() );
/*
  CPPUNIT_FAIL( "not implemented" );
*/
}

void MoneyTest::testEqual()
{
  // Set up
  const Money money123FF( 123, "FF" );
  const Money money123USD( 123, "USD" );
  const Money money12FF( 12, "FF" );
  const Money money12USD( 12, "USD" );

  // Process & Check
  CPPUNIT_ASSERT( money123FF == money123FF );     // ==
  CPPUNIT_ASSERT( money12FF != money123FF );      // != amount
  CPPUNIT_ASSERT( money123USD != money123FF );    // != currency
  CPPUNIT_ASSERT( money12USD != money123FF );    // != currency and != amount
}

void MoneyTest::testAdd()
{
  // Set up
  const Money money12FF( 12, "FF" );
  const Money expectedMoney( 135, "FF" );

  // Process
  Money money( 123, "FF" );
  money += money12FF;

  // Check
  CPPUNIT_ASSERT_EQUAL( expectedMoney, money );           // += works
//  CPPUNIT_ASSERT_EQUAL( expectedMoney == money.getAmount() );  // += works

  CPPUNIT_ASSERT( &money == &(money += money12FF) );           // += returns ref. on 'this'.
}

void MoneyTest::testAddThrow()
{
  // Set up
  const Money money123FF( 123, "FF" );

  // Process
  Money money( 123, "USD" );
  money += money123FF;        // should throw an exception
}


#include <cppunit/CompilerOutputter.h>
#include <cppunit/extensions/TestFactoryRegistry.h>
#include <cppunit/ui/text/TestRunner.h>

int main(int argc, char* argv[])
{

  // Get the top level suite from the registry
  CppUnit::Test *suite = CppUnit::TestFactoryRegistry::getRegistry().makeTest();

  // Adds the test to the list of test to run
  CppUnit::TextUi::TestRunner runner;
  runner.addTest( suite );

  // Change the default outputter to a compiler error format outputter
  runner.setOutputter( new CppUnit::CompilerOutputter( &runner.result(),
                                                       std::cerr ) );

  // Run the tests.
  bool wasSucessful = runner.run();

//    printf("Hello World!\n");
  // Return error code 1 if the one of test failed.
  return wasSucessful ? 0 : 1;
//    return 0;
}

2. 테스트 대상인 개체 클래스를 추가해서 컴파일은 되지만 실패하게 만든다.

#if !defined(AFX_MONEY_H__F1D93F74_365C_44D4_B575_90909D13DF59__INCLUDED_)
#define AFX_MONEY_H__F1D93F74_365C_44D4_B575_90909D13DF59__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include <string>

class IncompatibleMoneyError : public std::runtime_error
{
public:
   IncompatibleMoneyError() : std::runtime_error( "Incompatible moneys" )
  {
  }
};

class Money  
{
public:
/*
    Money();
    virtual ~Money(); */
public:
  Money( double amount, std::string currency )
    : m_amount( amount )
    , m_currency( m_currency )
  {
  }

  double getAmount() const
  {
    return m_amount;
  }

  std::string getCurrency() const
  {
    return m_currency;
  }

  bool operator ==( const Money &other ) const
  {
    return m_amount == other.m_amount  && 
           m_currency == other.m_currency;
  }

  bool operator !=( const Money &other ) const
  {
    return !(*this == other);
//    return (*this == other);
  }

  Money &operator +=( const Money &other )
  {
    if ( m_currency != other.m_currency )
      throw IncompatibleMoneyError();

    m_amount += other.m_amount;
    return *this;
  }

private:
  double m_amount;
  std::string m_currency;
};

#include <cppunit/portability/Stream.h>    // or <iostream> if portability is not an issue

// The function below could be prototyped as:
// inline std::ostream &operator <<( std::ostream &os, const Money &value )
// If you know that you will never compile on a platform without std::ostream
// (such as embedded vc++ 4.0; though even that platform you can use STLPort)
inline CPPUNIT_NS::OStream &operator <<( CPPUNIT_NS::OStream &os, const Money &value )
{
    return os << "Money< value =" << value.getAmount() << "; currency = " << value.getCurrency() << ">";
}

#endif // !defined(AFX_MONEY_H__F1D93F74_365C_44D4_B575_90909D13DF59__INCLUDED_)

#include "Money.h"

//////////////////////////////////////////////////////////////////////
// Construction/Destruction
//////////////////////////////////////////////////////////////////////
/*
Money::Money()
{

}

Money::~Money()
{

}
*/

3. 테스트가 성공하도록 개체 클래스 모듈을 수정한다.

4. 리팩토링을 한다.


참조 사이트:

http://cppunit.sourceforge.net/doc/lastest/money_example.html
http://www.cs.nmsu.edu/~jeffery/courses/371/cppunit/class_compiler_outputter.html#_details

http://crazia.tistory.com/tag/Simple%20Test%20Case
http://crazia.tistory.com/entry/CppUnit-Fixture
http://crazia.tistory.com/entry/CppUnit-Suite-TestRunner
http://cppunit.sourceforge.net/doc/lastest/cppunit_cookbook.html
http://elky.tistory.com/category/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4%20%EA%B0%9C%EB%B0%9C/%ED%85%8C%EC%8A%A4%ED%8A%B8%20%EC%A3%BC%EB%8F%84%20%EA%B0%9C%EB%B0%9C