主要内容

matlab.unittest.plugins.TAPPlugin.producingVersion13

类:matlab.unittest.plugins.TAPPlugin
包:matlab.unittest.plugins

构造TAPPlugin下载版本13 TAP格式

描述

例子

matlab.unittest.plugins.TAPPlugin.producingVersion13创建一个插件,以TAP格式的第13版生成输出。TAP版本13的输出包括YAML块中的测试诊断。默认情况下,插件使用ToStandardOutput流,输出显示在屏幕上。在这种情况下,发送到屏幕的其他输出可以使TAP流无效。

matlab.unittest.plugins.TAPPlugin.producingVersion13 (将所有文本输出重定向到指定的输出流。例如,可以将输出重定向到去整理流。

matlab.unittest.plugins.TAPPlugin.producingVersion13 (___名称,值创建带有一个或多个指定的附加选项的插件名称,值对参数。

输入参数

全部展开

控件的实例指定的插件指向文本输出的位置OutputStream类。默认情况下,插件使用ToStandardOutput流。

例子:stream = matlab.automation.streams.ToStandardOutput

例子:stream = matlab.automation.streams.ToFile('myFile.tap')

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。

在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字在报价。

例子:TAPPlugin。producingVersion13 (LoggingLevel, Verbosity.Detailed)创建一个插件,其中包括在详细的的水平。

是否包括传递事件诊断,指定为真正的.默认情况下,插件不包括对传递事件的诊断。

数据类型:逻辑

插件实例包含日志诊断的最大级别,指定为从0到4的整数值matlab.automation.Verbosity枚举对象,或与预定义的枚举成员名之一对应的字符串标量或字符向量。该插件包括记录在该级别及以下级别的诊断。类的成员对应整型值matlab.automation.Verbosity枚举。

数字表示法 枚举成员名 冗长的描述
0 没有一个

任何信息

1 简洁

最小的信息

2 简洁的

信息量适中

3. 详细的

一些补充信息

4 详细的

大量的补充信息

默认情况下,插件包括记录在matlab.automation.Verbosity.Terselevel(级别1)。排除日志诊断,请指定LoggingLevel作为冗长。没有一个(0级)。

的调用提供给测试框架的诊断日志(TestCase)日志(夹具)方法。

所报告事件的详细级别,指定为从0到4的整数值matlab.automation.Verbosity枚举对象,或与预定义的枚举成员名之一对应的字符串标量或字符向量。类的成员对应整型值matlab.automation.Verbosity枚举。

插件报告通过、失败和记录的事件,其详细数量由OutputDetail.默认情况下,插件记录事件在matlab.automation.Verbosity.Detailed级别(三级)。

数字表示法 枚举成员名 冗长的描述
0 没有一个

任何信息

1 简洁

最小的信息

2 简洁的

信息量适中

3. 详细的

一些补充信息

4 详细的

大量的补充信息

例子

全部展开

在工作文件夹中的新文件中,创建ExampleTest.m包含以下测试类。

classdefExampleTest < matlab.unittest.TestCase方法(测试)函数testOne (testCase)%测试失败testCase.verifyEqual (5 4“测试5 = = 4”结束函数testTwo (testCase)测试合格率testCase.verifyEqual (5 5“测试5 = = 5”结束函数testThree (testCase)%测试代码结束结束结束

在命令提示符下,从ExampleTest类。

进口matlab.unittest.TestRunner进口matlab.unittest.TestSuite进口matlab.unittest.plugins.TAPPlugin进口matlab.automation.streams.ToFileTestSuite.fromClass(?ExampleTest);

创建一个测试运行器,使用默认插件将输出显示到命令窗口。

runner = testrrunner . withtextoutput;

创建一个TAPPlugin将输出发送到文件MyTapOutput.tap

tapFile =“MyTAPOutput.tap”;plugin = TAPPlugin.producingVersion13(ToFile(tapFile));

将插件添加到TestRunner然后运行这个套件。

run . addplugin (plugin) result = run .run(suite);
运行ExampleTest  ================================================================================ 验证失败ExampleTest / testOne。---------------- 测试诊断 : ---------------- 测试5 = = 4  --------------------- 框架的诊断 : --------------------- verifyEqual失败了。——>使用"isequaln"两个数值不相等。——>失败表:实际RelativeError预期错误  ______ ________ _____ _____________ 5 4 1 0.25实际值:5期望值:4  ------------------ 堆栈信息 : ------------------ 在C: \ \ ExampleTest工作。在4米(ExampleTest.testOne)  ================================================================================ ...完成ExampleTest  __________ 失败失败总结:名字不完整的原因(s ) ================================================================== ExampleTest / testOne X验证失败。

显示插件创建的文件。

disp (fileread (tapFile))
TAP版本13 1..3.not ok 1 - ExampleTest/testOne --- Event: Event Name: 'VerificationFailed' Event Location: 'ExampleTest/testOne' Test Diagnostic: | Testing 5==4 Framework Diagnostic: | verifyEqual failed. --> The numeric values are not equal using "isequaln". --> Failure table: Actual Expected Error RelativeError ______ ________ _____ _____________ 5 4 1 0.25 Actual Value: 5 Expected Value: 4 Stack: | In C:\work\ExampleTest.m (ExampleTest.testOne) at 4 ... ok 2 - ExampleTest/testTwo ok 3 - ExampleTest/testThree

您可以使用TAPPlugin定向到标准输出。然而,任何其他显示到标准输出的文本(例如失败的测试信息)都会中断流,并有可能使其失效。

版本历史

在R2016b中引入