CppUnit：运行单个测试用例

Question

在 http://cppunit.sourceforge.net/doc/lastest/cppunit_cookbook.html

他们给出了一个简单的测试用例，但没有展示如何运行它（没有 main 函数）。我浏览了他们的文档，但找不到如何运行测试并获取有关测试是否成功的文本输出。我不想组装固定装置或使用注册表或任何东西。

我如何运行该单个测试用例？ IE 与之相关的 main 函数是什么？

Answer 1

我猜你是在要求 CppUnit 的 SSCCE。由于 CppUnit 是一个框架，因此一个最小的示例必须放置最小的测试结构 - 就像 TestFixture，因为否则可以不需要整个 CppUnit，而只使用 std::assert。所有这些都可以在一个文件中完成，例如以下形式的 Main.cpp：

//Declaration file: MTest.h
#ifndef MTEST_H
#define MTEST_H
#include <cppunit/extensions/HelperMacros.h>

class MTest : public CPPUNIT_NS::TestFixture
{
  CPPUNIT_TEST_SUITE(MTest);
  CPPUNIT_TEST(simpleTest);
  CPPUNIT_TEST_SUITE_END();
public:
  void simpleTest();
};
#endif  // MTEST_H

//////////////////////////////////////
// Implementation file, e.g. MTest.cpp
#include <cppunit/config/SourcePrefix.h>
//#include "MTest.h"

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

// Some code to be tested.
void MTest::simpleTest() {
  CPPUNIT_ASSERT_EQUAL(1, 2);
}

/////////////////////////////////////
// Main file, Main.cpp
#include <cppunit/extensions/TestFactoryRegistry.h>
#include <cppunit/ui/text/TestRunner.h>

int main(int argc, char* argv[])
{
  CPPUNIT_NS::TextUi::TestRunner runner;   //the runner
  // Get the top level suite from the registry
  CPPUNIT_NS::Test* suite = 
      CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest();
  // Adds the test to the list of test to run
  runner.addTest(suite);  
  // Run the test.
  bool wasSucessful = runner.run();
  // Return error code 1 if the one of test failed.
  return wasSucessful ? 0 : 1;
}

需要使用 cppunit 库进行编译/链接，例如 g++ Main。 cpp ../../src/cppunit/.libs/libcppunit.a（如果您碰巧在库主目录以下的 2 级启动[插入 libcppunit您的环境需要的库]）。

例如，“清理器”会将代码拆分为单独的 MTest（.h 和 .cpp，如所示）和 Main.cpp。在本例中，Main.cpp 中的 CppUnit 方法调用由 MTest 文件中的 CppUnit 辅助宏提供的方法。因此，它们应该链接在一起，例如通过g++ MTest.o Main.o ../../src/cppunit/.libs/libcppunit.a。

Answer 2

所有测试类的基类是CppUnit::TestFixture，您可以重写一些函数，例如setUp和tearDown来初始化测试对象并删除它们。

假设您有一个名为 MyFirstTest 的测试类，要向 Cpp 框架注册测试函数，您必须执行以下操作：

CPPUNIT_TEST_SUITE(MyFirstTest);
CPPUNIT_TEST(myTestFunction);
... //any other function you want to register with appropriate macros
CPPUNIT_TEST_SUITE_END();

此外，您还必须注册每个测试类（在其各自的头文件或 cpp 文件中）

CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(MyFirstTest, "YouTestName");

。测试类已设置，您可以运行它。主要功能将如下所示：

bool wasSuccessful = false;

    try
    {
        CppUnit::TextUi::TestRunner runner;
        runner.setOutputter( new CppUnit::CompilerOutputter(&runner.result(), std::cerr));
        CppUnit::TestFactoryRegistry ®istry = CppUnit::TestFactoryRegistry::getRegistry("YouTestName");
        runner.addTest(registry.makeTest());
        wasSuccessful = runner.run("", false);
    }
    catch(const std::exception& e)
    {
        std::cerr << e.what() << std::endl;
        wasSuccessful = false;
    }

如果您希望添加更多测试类，主要功能将保持不变。您只需创建测试类（从 CppUnit::TestFixture 类派生），注册您的方法，重要的一步是使用 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION 向框架注册您的类。 main 函数中使用的 getRegistry 方法将获取您在框架中注册的所有测试类，并执行您已注册的这些类的所有方法CPPUNIT_TEST 或任何其他适当的宏。

Answer 3

您所指的页面描述了整个过程，包括许多额外的内容，包括如何在 TestFixtures 中手动编写代码，然后如何在 TestSuites 中注册这些代码，然后如何使用宏来编写并注册它们，这很罗嗦。有时，向人们展示一个简单的例子会更好。他们在页面的最底部有一个：

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

int main( int argc, char **argv)
{
  CppUnit::TextUi::TestRunner runner;
  CppUnit::TestFactoryRegistry ®istry = CppUnit::TestFactoryRegistry::getRegistry();
  runner.addTest( registry.makeTest() );
  bool wasSuccessful = runner.run( "", false );
  return wasSuccessful;
}

基础设施非常简单，真的。您创建一个测试运行程序，然后检索已注册测试的列表，将它们添加到运行程序中，让运行程序运行测试，并向您报告。但是，是的，让事情变得简单总是最好的。人们不想做困难的事情。

Answer 4

简单但愚蠢的解决方案：注释掉您不喜欢的 CPPUNIT_TEST 行。