使用测试笔记本

Wolfram 笔记本为编写和运行代码测试提供了便捷的界面.
入门
在 Mathematica 菜单中,点击 文件 新建 可编程的笔记本 测试笔记本. 将会打开一个测试笔记本. (这里描述的笔记本已通过 文件 另存为... 保存,文件名为 MyTests.)

1.gif

点击 添加 按钮对笔记本插入一个测试.

2.gif

输入单元,输入或者粘贴测试的输入. 在预期输出单元,输入或者粘贴应该有的输出.

3.gif

如果在运行测试时,预期产生消息,使用 添加消息 按钮添加消息. 您也可以把选项添加到单个测试,例如 MemoryConstraintSameTestTestIDTimeConstraint,使用按钮 添加选项 右边的下拉菜单.

4.gif

如要在测试之外定义值或运行设置代码,请在测试前单击 More Insert Environ Cell 来插入 Environ 单元.
这将创建一个具有浅灰色背景的 Environ 单元. Environ 单元中的表达式在测试运行期间将被运算 ,而常规输入单元格的内容则被忽略.
使用笔记本界面运行测试
本章节演示了在给定笔记本中运行所有测试.

6.gif

点击 运行 按钮将计算测试笔记本中的所有测试. 测试结果将插入计算的单个测试中,并且当测试运行结束时,在笔记本顶端将插入一个测试报告总结. 下面的笔记本显示了四种可能的测试结果:成功、失败、消息失败和错误. 清除测试结果 按钮可以用于从笔记本清除测试结果.

7.gif

该测试报告总结提高了测试运行的详细次数,以及成功、错误、由于错误结果造成的失败、由于消息造成的失败的具体次数.另外,一个总结栏描述了测试结果,并且提供了两种对测试结果排序的模式:通过状态和按顺序. 当测试笔记本中的总测试次数为 50 或更少时,总结栏里的每个 tab 连到它的测试. 在右下角,有两个按钮,查询相对于光标位置的前一个和下一个失败的测试.

8.gif

使用测试结果
下面是一个成功的测试. 如果您想要修改这个测试,并且重新查看输出,您可以使用 重新运行 按钮:

9.gif

下面是由于错误结果导致的失效. 当实际输出与预期输出不同,就出现这种情况. 如果实际输出是正确的结果,那么预期输出可以通过点击 Replace Output 按钮改变为正确结果. 接下来,测试可以使用 Rerun 按钮重新运行:

10.gif

下面是一个失效消息. 这是一个实际的消息. 由于没有具有该消息的预期消息单元,因此测试失效. 替代消息列表 按钮可以用于以实际消息单元插入预期消息单元的内容. 该测试可以使用 重新运行 按钮重新运行:

11.gif

下面是一个测试错误. 修复测试选项单元中选项的右边,并且使用 重新运行 按钮:

12.gif

产生 .wlt 文件
点击 更多 另存为 .wlt 把笔记本中的测试保存为 .wlt 文件. 将产生一个文件保存选择器,允许您选择文件名称,并且保存到目录.

13.gif

下面的文件名称选为 MyTests2,并且被保存到目录 C:\\Users\\xyz\\Desktop. 这生成该文件的报告.
这是报告的属性.
这是测试结果规则.
下面给出对第一个失败的测试的预期输出和实际输出. 对于这个测试文件,只有一个失败的测试.
分配 TestID
点击 更多 分配 TestID 在笔记本中对所有测试分配 TestID.

15.gif

下面是分配了 TestID 的测试单元组.

16.gif

笔记本转换
您可能想要把具有输入、消息和输出的笔记本转化为一个测试笔记本. 在该笔记本为输入笔记本的情况下,点击 窗口 工具条 测试. 对笔记本顶端添加 docked 单元. 然后点击按钮 转换为测试笔记本.

17.gif

具有 Code 单元样式的单元将转换为测试笔记本中的 Environ 单元.