查看源代码 测试结构

概述

测试是通过运行一个或多个测试套件来执行的。一个测试套件由测试用例、配置函数和信息函数组成。测试用例可以分组到所谓的测试用例组中。测试套件是一个 Erlang 模块，测试用例被实现为 Erlang 函数。测试套件存储在测试目录中。

跳过测试用例

某些测试用例可以被跳过，例如，如果您预先知道某个特定的测试用例会失败。原因可能是尚未实现的功能、已知但尚未修复的错误，或者某些功能在特定平台上不起作用或不适用。

测试用例可以通过以下方式跳过：

  • 在测试规范中使用 skip_suites 和 skip_cases 项。
  • 从函数 init_per_testcase/2 或 init_per_suite/1 返回 {skip,Reason}。
  • 从测试用例的执行子句返回 {skip,Reason}。执行子句会被调用，因此作者必须确保测试用例不会运行。

当测试用例被跳过时，它在 HTML 日志中被标记为 SKIPPED。

术语定义

  • 自动跳过的测试用例 - 当配置函数失败（即意外终止）时，依赖于该配置函数的测试用例会被 Common Test 自动跳过。测试用例的状态随后变为“自动跳过”。如果运行时无法获取所需的配置数据，Common Test 也会“自动跳过”测试用例。

  • 配置函数 - 测试套件中的一个函数，用于设置、清理和/或验证被测系统 (SUT) 和/或 Common Test 主机节点上的状态和环境，以便测试用例（或一组测试用例）可以正确执行。

  • 配置文件 - 包含与测试和/或 SUT 相关的数据的文件，例如，协议服务器地址、客户端登录详细信息和硬件接口地址。也就是说，任何要在套件中作为变量处理而不是硬编码的数据。

  • 配置变量 - 与从配置文件读取的数据值关联的名称（Erlang 原子）。

  • data_dir - 测试套件的数据目录。此目录包含测试套件使用的任何文件，例如，额外的 Erlang 模块、二进制文件或数据文件。

  • 信息函数 - 测试套件中的一个函数，它返回一个属性列表（由 Common Test 服务器读取），描述了执行套件中测试用例的条件。

  • 主要日志文件 - 一个或多个测试套件的概述和摘要日志文件。

  • 次要日志文件 - 特定测试用例的日志文件。也称为测试用例日志文件。

  • priv_dir - 测试套件的私有目录。当测试套件需要写入文件时，应使用此目录。

  • ct_run - 一个可执行程序的名称，可以用作指定和运行 Common Test 测试的接口。

  • 测试用例 - 测试套件中包含的单个测试。测试用例被实现为测试套件模块中的一个函数。

  • 测试用例组 - 一组共享配置函数和执行属性的测试用例。执行属性指定组中的测试用例是以随机顺序、并行还是顺序执行，以及是否重复执行该组。测试用例组也可以嵌套。也就是说，一个组除了测试用例外，还可以包含子组。

  • 测试套件 - 一个 Erlang 模块，包含特定功能区域的一组测试用例。

  • 测试目录 - 包含一个或多个测试套件模块的目录，即一组测试套件。

  • 参数 Config - 键值对的列表（即属性列表），包含从配置函数传递到测试用例的运行时配置数据。

  • 用户跳过的测试用例 - 按照 跳过测试用例 部分中描述的任何方式显式跳过的测试用例的状态。