您可以捕获测试用例中的函数快照,用于回归测试。测试用例还可以识别可能导致异常的条件,这些异常可能导致系统和应用程序不稳定、安全漏洞(例如拒绝服务攻击)、性能和应用程序响应时间不佳以及频繁停机。

内容包括:

关于自动测试用例生成

C++test 根据测试配置的生成选项卡中定义的参数自动生成测试用例。这些测试用例使用的格式类似于主流的 CppUnit 格式。

如果要验证新代码的功能性,建议您为每个函数自动生成 1-2 个测试。

生成并执行这些测试之后,您可以按照扩展和修改测试套件中的说明使用用户自定义的测试用例扩展测试套件。

如果要创建代码当前行为的快照以建立回归测试基线(例如,如果您确信代码的行为符合预期),则可以使用“Unit Testing> Generate Regression Base”内建测试配置来运行测试。运行此测试配置时,C++test 将自动验证所有结果。

然后可以定期(例如,每 24 小时一次)自动运行这些测试,以验证代码修改是否更改或破坏了回归测试中捕获的函数。如果进行了任何更改,这些测试用例将会失败,以提醒团队注意该问题。

在后续测试中,如果 C++test 检测到初始测试中捕获的行为发生变化,则会报告任务。不需要进行验证。

使用默认设置,C++test 为每个源/头文件生成一个测试套件。也可以将其配置为每个函数生成一个测试套件或每个源文件生成一个测试套件(详细信息请参阅自定义生成选项)。

安全桩函数定义会自动生成以替换“危险”函数,其中包括系统 I/O 例程,例如 rmdir()remove()rename() 等。此外,可以针对缺少的函数和变量定义自动生成桩函数。(详细信息,请参阅了解和自定义自动桩函数生成)。可以根据需要添加用户定义的桩函数(详细信息,请参阅添加和修改桩函数)。

生成测试用例

生成测试用例的一般过程:

  1. 根据您所需的测试生成设置来查找或创建测试配置。
  2. 运行测试配置
  3. 查看生成的测试用例。
  4. (可选)根据需要调整测试生成设置。

自定义生成选项

您可以通过自定义测试配置的生成选项卡中的选项来控制各种生成选项。

控制测试套件的文件名、位置和布局

可以通过在测试配置的生成> 测试套件选项卡中自定义选项来控制生成的测试套件的文件名、位置和粒度/布局。

要更改默认的测试套件输出设置,首先从测试套件输出文件和布局框中选择以下三个预定义的输出和布局选项之一:

如果选择了为每个被测函数创建一个测试套件选项,为示例 ATM 项目(包括在 examples 目录中)生成的测试套件如下所示:



如果选择为每个被测源/头文件创建一个测试套件,为示例 ATM 项目(包括在 examples 目录中)生成的测试套件如下所示:




选择这些选项之一后,您可以根据需要自定义模式(例如,将测试生成到源位置)。使用自定义模式时,可以使用以下变量:

  • file = 定义了被测函数的源/头文件。
  • source file = 定义了定义被测函数的编译单元的源文件。

删除一些变量可能导致测试套件重叠。C++test 将通过显示错误消息“测试套件的输出文件模式不明确”来提醒您。

针对更改生成测试位置的基本模式,C++test 使用以下内部检查和限制: 

  • 所有自动生成的测试都是“包含”类型(测试套件文件与指定的源文件/编译单元“粘合”在一起)。
  • 尝试防止将来自不同编译单元的函数测试用例放入同一个测试套件文件的情况(因为无法将这样的测试套件文件与原始的源文件正确地“粘合”)。
  • C++test 拥有不同的变量(根据被测文件、文件名、位置等来解析),可用于让测试套件的文件模式变得明确(就上述内容而言)。
  • 一种常用的策略是将测试套件文件生成到包含原始文件名称/位置的文件或位置中。以下是默认的模式:

    ${project_loc}/tests/autogenerated/${file_loc_rel}/
    TestSuite_${file_base_name}_${file_ext}.${test_ext}

    这种模式更明确是因为使用了 ${file_loc_rel} 和 ${file_base_name} 变量(即使项目中有许多同名文件,它们的位置也会有所不同,并且该位置将成为套件文件名/位置的一部分)。
  • 还有其他可用变量,例如 ${file_uid}、${src_file_uid},可以使用它们代替 ${file_loc_rel}/${file_base_name},同时保持模式明确。这些变量被解析为原始文件位置的哈希码。例如,像

    ${project_loc}/tests/autogenerated/
    TestSuite_${file_base_name}_${file_uid}_${file_ext}.${test_ext}

    这样的模式将会生成如下测试套件:

    ATM/tests/autogenerated/TestSuite_Account_d7a5efc6_hxx.cpp

追加或替换现有测试

您还可以控制当生成的测试文件与现有的测试套件文件具有相同的名称和位置时,C++test 是追加测试还是替换现有测试。此行为由当为具有现存测试套件的代码生成测试设置决定,该设置提供以下选项:

在测试套件文件中寻找 CPPTEST_CONTEXT 和 CPPTEST_TEST_SUITE_INCLUDED_TO 标记。

常见测试生成目标

下表说明了如何配置测试配置的生成选项以实现常见的测试生成目标。涵盖的选项包括生成> 常规选项卡的为代码生成测试选项和生成> 测试套件选项卡的当为具有现存测试套件的代码生成测试选项。 

目标设置
生成一组初始测试对于为代码生成测试,启用没有测试套件。指定其他参数(函数访问级别、输出文件位置/名称等)。
使用新函数的测试更新现有的自动生成的测试套件(不生成新的测试套件)

对于为代码生成测试,启用具有最新的测试套件具有过期的测试套件

对于当为具有现存测试套件的代码生成测试,启用为没有测试的函数添加测试

指定其他参数(函数访问级别、输出文件位置/名称等)。

将自动生成的测试与当前代码同步-追加缺失的测试,创建缺失的测试套件

对于为代码生成测试,启用没有测试套件具有最新的测试套件具有过期的测试套件

对于当为具有现存测试套件的代码生成测试,启用为没有测试的函数添加测试

指定其他参数(函数访问级别、输出文件位置/名称等)。

完全重置现有的自动生成的测试

对于为代码生成测试,启用没有测试套件具有最新的测试套件具有过期的测试套件

对于当为具有现存测试套件的代码生成测试,启用替代现有的测试套件

指定其他参数(函数访问级别、输出文件位置/名称等)。

C++test 将所有自动生成的测试保留在原始项目位置。使用项目目录作为根位置,将自动创建适当的目录结构(类似于解决方案资源管理器视图)。

选择符合您目标的布局选项

本部分说明如何配置测试套件输出文件和布局选项(在测试配置的生成> 测试套件选项卡中)以满足各种布局需求。为帮助您了解所讨论的每个选项如何转换为实际项目,我们展示了对以下示例项目的影响:

MyProject
 Header Files
   MyClass.h // contains foo() definition
 Source Files
   MyClass.cpp // contains bar() and goo() definitions 

要为每个函数生成一个测试套件文件,将测试保存在单独的目录中

使用${project_loc}/tests/${file_loc_rel}/${file_name}/
TestSuite_${function_name}.${test_ext}

示例布局:

MyProject
 Header Files
   MyClass.h
 Source Files
   MyClass.cpp
 tests
   Header Files
     MyClass.h
	TestSuite_foo.cpp // contains tests for foo()
   Source Files
     MyClass.cpp
	TestSuite_bar.cpp // contains tests for bar()
	TestSuite_goo.cpp // contains tests for goo() 

要为每个源/头文件生成一个测试套件文件,将测试保存在单独的目录中

使用 ${project_loc}/tests/${file_loc_rel}/
TestSuite_${file_base_name}_${file_ext}.${test_ext}

示例布局:

MyProject
 Header Files
   MyClass.h
 sSource Files
   MyClass.cpp
 tests
   Header Files
     TestSuite_MyClass_h.cpp // contains tests for foo()
   Source Files
     TestSuite_MyClass_cpp.cpp // contains tests for bar() and goo()

要为每个源/头文件生成一个测试套件文件,将测试与被测文件保存在一起

使用 ${project_loc}/${file_loc_rel}/tests/
TestSuite_${file_base_name}_${file_ext}.${test_ext}

示例布局:

 Header Files
   MyClass.h
   tests
     TestSuite_MyClass_h.cpp // contains tests for foo()
 Source Files
   MyClass.cpp
   tests
     TestSuite_MyClass_cpp.cpp // contains tests for bar() and goo()