Wolfram 语言与系统参考资料中心

TestReport

TestReport["file"]

给出一份文件中的测试结果报告.

TestReport[{test₁,test₂,…}]

给出 test_i 结果的报告.

TestReport[{report₁,report₂,…}]

通过合并所有测试报告 report_i 给出统一的报告.

范例

打开所有单元关闭所有单元

基本范例 (2)

运行一个 TestObject 列表：

Wolfram Language code:

TestReport[{TestCreate[Sin[E] > Cos[E]], TestCreate[MatrixQ[{{1, 2, 3}, {4, 5, 6, 7}}]], TestCreate[1 / 0, ComplexInfinity]}]

运行笔记本中的例子作为测试：

Wolfram Language code: report = TestReport[FileNameJoin[{"ExampleData", "ExampleTestFile.nb"}]]

提取失败测试的信息并在 TabView 中呈现：

Wolfram Language code: TabView[Column /@ report["ResultsByOutcome"]]

将现有的 TestReportObject 与新的报告合并：

Wolfram Language code: TestReport[{TestCreate[1 + 1, 2], report}]

范围 (1)

基本用途 (1)

运行一系列测试：

Wolfram Language code:

report = TestReport[{TestCreate[Limit[Exp[t], t -> 0], 2], TestCreate[PrimeQ[7]], 
	TestCreate[Factor[1 - 2x + x^2], (x + 1)^2], 
	TestCreate[Infinity - Infinity, Indeterminate]}]

TestReportObject 的属性：

Wolfram Language code: report["Properties"]

个别测试结果的列表：

Wolfram Language code: report["ResultList"]

比较预期的和实际的测试结果的不同之处：

Wolfram Language code: Dataset[Map[#[{"ExpectedOutput", "ActualOutput"}]&, Flatten[Values[KeyDrop[report["ResultsByOutcome"], "Success"]]]]]

选项 (10)

HandlerFunctions (1)

使用 HandlerFunctions 记录 TestReport 执行过程中发生的测试事件：

Wolfram Language code:

TestReport[
	TestCreate[1, 1], 
	HandlerFunctions -> <|"TestEvaluated" -> Print|>
	]

使用特殊键 "UnhandledEvent" 记录所有事件：

Wolfram Language code:

TestReport[
	{TestCreate[1, 1], TestCreate[0, 1]}, 
	HandlerFunctions -> <|"UnhandledEvent" -> Print|>
	]

Wolfram Language code:

TestReport[
	{TestCreate[1, 1], TestCreate[0, 1]}, 
	HandlerFunctions -> <|
	"UnhandledEvent" -> Function[Print[Style[#, Gray]]], 
	"TestEvaluated" -> Function[Print[Style[#, Blue]]]
	|>
	]

HandlerFunctionsKeys (1)

使用 HandlerFunctionsKeys 来选择在使用 HandlerFunctions 时关注的键:

Wolfram Language code:

TestReport[
	TestCreate[0, 1], 
	HandlerFunctions -> <|"UnhandledEvent" -> Print|>, 
	HandlerFunctionsKeys -> {"EventName", "EventID"}
	]

如果某事件不能提供你所要求的密钥，则其不会出现在 Association 中：

Wolfram Language code:

TestReport[
	TestCreate[0, 1], 
	HandlerFunctions -> <|"UnhandledEvent" -> Print|>, 
	HandlerFunctionsKeys -> {"EventName", "TestObject"}
	]

MemoryConstraint (2)

对每次测试应用一个内存约束：

Wolfram Language code: report = TestReport[{TestCreate[Head @ RandomImage[], Image]}, MemoryConstraint -> Quantity[250, "Bytes"]]

Wolfram Language code: test = First @ report["Results"]

Wolfram Language code: test["ActualOutput"]

特定的 TestCreate 选项覆盖在 TestReport 层面上设置的选项：

Wolfram Language code:

TestReport[{TestCreate[Head @ RandomImage[], Image, MemoryConstraint -> Quantity[250, "Bytes"]]}, MemoryConstraint -> Quantity[10, "Megabytes"]]

ProgressReporting (1)

长时间测试运行会自动显示进度报告：

Wolfram Language code:

TestReport[
	Table[
	TestCreate[RandomInteger[], 1], 
	20000
	]
	]

使用选项 ProgressReporting 关闭该功能：

Wolfram Language code:

TestReport[
	Table[
	TestCreate[RandomInteger[], 1], 
	20000
	], 
	ProgressReporting -> False
	]

如要在全局范围内禁用进度报告，简单的方法是覆盖 $ProgressReporting：

Wolfram Language code:

Block[
	{$ProgressReporting = False}, 
	TestReport[
	Table[
	TestCreate[RandomInteger[], 1], 
	10000
	], 
	ProgressReporting -> False
	]
	]

SameTest (2)

将 SameTest 应用于给定测试：

Wolfram Language code:

TestReport[{
	TestCreate[RandomInteger[10], _Integer], TestCreate[RandomReal[10], _Real]
	}, 
	SameTest -> MatchQ
	]

Wolfram Language code:

TestReport[{
	TestCreate[1 + 1, 2], 
	TestCreate[1. + 10 ^ -14, 1]
	}, 
	SameTest -> (Chop[#1 - #2, 10^-12] == 0&)
	]

特定的 TestCreate 选项会覆盖在 TestReport 层面上设置的选项：

Wolfram Language code:

TestReport[{
	TestCreate[RandomInteger[10], _Integer], TestCreate[{1, 2, 3}, {3, 2, 1}, SameTest -> (Sort[#1] == Sort[#2] &)]}, 
	SameTest -> MatchQ
	]

TestEvaluationFunction (1)

打印笔记本中的所有测试，而不对其进行运算：

Wolfram Language code:

TestReport[
	TestCreate[1, 1], 
	TestEvaluationFunction -> Echo
	]

在运算前将所有测试打印在笔记本上，然后进行运算：

Wolfram Language code:

TestReport[
	TestCreate[1, 1], 
	TestEvaluationFunction -> Echo /* TestEvaluate
	]

TimeConstraint (2)

对所有给定的测试应用时间约束：

Wolfram Language code: Simplify[2Sin[10x + 11y + z]Cos[10x + 10y + 10t]]//AbsoluteTiming

Wolfram Language code:

report = TestReport[{TestCreate[Simplify[2Sin[10x + 11y + z]Cos[10x + 10y + 10t]], 2 Cos[10 (t + x + y)] Sin[10 x + 11 y + z]]}, TimeConstraint -> Quantity[1, "Seconds"]]

Wolfram Language code: test = First @ report["TestResults"]

Wolfram Language code: test["ActualOutput"]

特定的 TestCreate 选项会覆盖在 TestReport 层面设置的选项：

Wolfram Language code:

TestReport[{TestCreate[Simplify[2Sin[10x + 11y + z]Cos[10x + 10y + 10t]], 2 Cos[10 (t + x + y)] Sin[10 x + 11 y + z], TimeConstraint -> Quantity[5, "Seconds"]]}, TimeConstraint -> Quantity[1, "Seconds"]]

应用 (1)

同时运行单个测试和测试文件的列表：

Wolfram Language code:

report = TestReport[{
	FileNameJoin[{"ExampleData", "ExampleTestFile.nb"}], 
	TestCreate[Sin[E] > Cos[E]], 
	TestCreate[MatrixQ[{{1, 2, 3}, {4, 5, 6, 7}}]], 
	TestCreate[1 / 0, ComplexInfinity]
	}]

再次使用 TestReport 将现有的 TestReportObject 合并为一个新的报告：

Wolfram Language code:

TestReport[
	{
	TestCreate[1 > 0], 
	report
	}
	]

使用 TestReport 合并多个 TestReportObject 实例时，重复的测试将自动从报告中删除：

Wolfram Language code: Length @ report["ResultList"]

Wolfram Language code: report = TestReport[{report, report, report}]

Wolfram Language code: Length @ report["ResultList"]

使用属性 "ResultsByTestFileName" 可将同一文件的测试分为一组：

Wolfram Language code: report["ResultsByTestFileName"]

属性和关系 (2)

在 HandlerFunctions 中使用 Throw 和 Catch，在测试失败时停止测试运行：

Wolfram Language code:

Catch @ TestReport[
	TestCreate[0, 1], 
	HandlerFunctions -> <|"TestEvaluated" -> Function[If[#Outcome != "Success", Throw[#TestObject]]]|>
	]

你也可以在 TestEvaluationFunction 中使用 Throw 和 Catch：

Wolfram Language code:

Catch @ TestReport[
	{
	TestCreate[1, 1], 
	TestCreate[1, 2]
	}, 
	TestEvaluationFunction -> Function[
	With[
	{test = TestEvaluate[#]}, 
	If[
	test["Outcome"] === "Success", 
	test, 
	Throw @ test
	]
	]
	]
	]

在 HandlerFunctions 中使用 Reap 和 Sow 以收集所有事件名称：

Wolfram Language code:

Reap @ TestReport[
	TestCreate[0, 1], 
	HandlerFunctions -> <|"UnhandledEvent" -> Function[Sow[#Event]]|>
	]

可能存在的问题 (2)

没有测试的 TestReport 会被判定为成功：

Wolfram Language code: tr = TestReport[{}]

Wolfram Language code: tr["ReportSucceeded"]

TestReport 将执行并收集独特的测试一次：

Wolfram Language code:

t = TestCreate[2 + 2, 4];
	
TestReport[{t, t, t}]

为了多次执行相同的测试，需要多次创建测试：

Wolfram Language code:

TestReport[{
	TestCreate[2 + 2, 4], 
	TestCreate[2 + 2, 4], 
	TestCreate[2 + 2, 4]
	}]

Top

	"FileStarted"	测试文件已开始
	"FileCompleted"	测试文件已完成
	"ReportStarted"	测试报告已开始
	"ReportCompleted"	测试报告已完成
	"RuntimeFailure"	遇到运行时故障
	"TestCreated"	测试已创建
	"TestEvaluated"	测试已运算

	"EventName"	处理的事件名称
	"EventID"	事件的唯一标识符
	"Failure"	与事件相关联的故障对象
	"FailureType"	与测试相关联的故障类型
	"Outcome"	与测试相关联的结果
	"TestFileName"	与事件相关联的测试文件名
	"TestObject"	与事件相关联的测试对象
	"Title"	测试报告的名称

更多学习资源

技术支持

数据科学、金融与商业

工程

科学与技术

教育科技

教育举措

开始

提高你的技能

与我们合作

成人教育计划

青少年教育计划

欢迎阅读

TestReport

更多信息和选项

范例

基本范例 (2)

范围 (1)

基本用途 (1)

选项 (10)

HandlerFunctions (1)

HandlerFunctionsKeys (1)

MemoryConstraint (2)

ProgressReporting (1)

SameTest (2)

TestEvaluationFunction (1)

TimeConstraint (2)

应用 (1)

属性和关系 (2)

可能存在的问题 (2)

文本

CMS

APA

BibTeX

BibLaTeX

HandlerFunctions	<\|\|>	句柄函数
HandlerFunctionsKeys	Automatic	向句柄函数提供哪些参数
MemoryConstraint	Infinity	每次测试允许使用的内存（字节）
ProgressReporting	$ProgressReporting	是否报告进度
SameTest	SameQ	用于比较实际和预期输出的函数
TestEvaluationFunction	TestEvaluate	计算所创建测试的函数
TimeConstraint	Infinity	每次测试允许使用的时间（秒）

TestReport

更多信息和选项

范例

基本范例 (2)

范围 (1)

基本用途 (1)

选项 (10)

HandlerFunctions (1)

HandlerFunctionsKeys (1)

MemoryConstraint (2)

ProgressReporting (1)

SameTest (2)

TestEvaluationFunction (1)

TimeConstraint (2)

应用 (1)

属性和关系 (2)

可能存在的问题 (2)

参见

技术笔记

相关指南

相关的工作流程

相关链接

历史

文本

CMS

APA

BibTeX

BibLaTeX