matlab.unittest.plugins.TAPPlugin.producingOriginalFormat

R2026b

类: matlab.unittest.plugins.TAPPlugin
命名空间: matlab.unittest.plugins

为原始 TAP 格式构造 TAPPlugin

全页展开

语法

plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat
plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(stream)
plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(___,Name=Value)

描述

plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat 创建一个可按原始 Test Anything Protocol (TAP) 格式（版本 12）生成输出的插件。默认情况下，该插件使用 ToStandardOutput 流，并且输出会显示在屏幕上。在本例中，发送到屏幕的其他输出可使 TAP 流失效。

示例

plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(stream) 将所有文本输出重定向到指定的输出流。例如，您可以将输出重定向到 ToFile 流。

plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(___,Name=Value) 支持上述语法中的任何输入参量组合，且可使用一个或多个名称-值参量指定选项。plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(LoggingLevel="detailed") 创建一个插件，该插件包含在 matlab.automation.Verbosity.Detailed 级别及更低级别记录的诊断信息。

输入参数

全部展开

插件要将文本输出定向到的位置，指定为 OutputStream 类的实例。默认情况下，插件使用 ToStandardOutput 流。

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

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

名称-值参数

全部展开

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

示例: plugin = matlab.unittest.plugins.TAPPlugin.producingOriginalFormat(LoggingLevel="detailed")

是否包含通过事件的诊断信息，指定为 false 或 true。默认情况下，该插件不包含来自通过事件的诊断信息。

数据类型: logical

要在测试报告中包含的已记录诊断的最大详细级别，指定为从 0 到 4 的整数标量、matlab.automation.Verbosity 枚举对象或枚举的文本表示。插件包括在指定级别及更低级别记录的诊断。

数值表示枚举成员名称详细程度描述
0None

无信息

1Terse

最少的信息

2Concise

适中信息量

3Detailed

部分补充信息

4Verbose

大量补充信息

默认情况下，插件包含在 matlab.automation.Verbosity.Terse 级别（级别 1）记录的诊断信息。要排除所记录的诊断信息，请将 LoggingLevel 指定为 matlab.automation.Verbosity.None（级别 0）。

记录的诊断是您使用 log (TestCase) 和 log (Fixture) 方法为测试框架提供的诊断。

示例: LoggingLevel="detailed"

报告事件的详细信息级别，指定为介于 0 和 4 之间的整数值、matlab.automation.Verbosity 枚举对象，或对应于预定义枚举成员名称之一的字符串标量或字符向量。整数值对应于 matlab.automation.Verbosity 枚举的成员。

该插件使用 OutputDetail 指定的信息量来报告通过事件、失败事件和日志记录事件。默认情况下，该插件在 matlab.automation.Verbosity.Detailed 级别（级别 3）记录事件。

数值表示枚举成员名称详细程度描述
0None

无信息

1Terse

最少的信息

2Concise

适中信息量

3Detailed

部分补充信息

4Verbose

大量补充信息

示例

全部展开

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

classdef ExampleTest < matlab.unittest.TestCase
    methods(Test)
        function testOne(testCase)  % Test fails
            testCase.verifyEqual(5,4,'Testing 5==4')
        end
        function testTwo(testCase)  % Test passes
            testCase.verifyEqual(5,5,'Testing 5==5')
        end
        function testThree(testCase)
            % test code
        end
    end
end

在命令提示符下，基于 ExampleTest 类创建测试套件。

import matlab.unittest.TestRunner
import matlab.unittest.TestSuite
import matlab.unittest.plugins.TAPPlugin
import matlab.automation.streams.ToFile

suite   = TestSuite.fromClass(?ExampleTest);

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

runner = TestRunner.withTextOutput;

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

tapFile = 'MyTAPOutput.tap';
plugin = TAPPlugin.producingOriginalFormat(ToFile(tapFile));

将该插接添加到 TestRunner 并运行套件。

runner.addPlugin(plugin)
result = runner.run(suite);
Running ExampleTest

================================================================================
Verification failed in 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 Information:
    ------------------
    In C:\work\ExampleTest.m (ExampleTest.testOne) at 4
================================================================================
...
Done ExampleTest
__________

Failure Summary:

     Name                 Failed  Incomplete  Reason(s)
    ==================================================================
     ExampleTest/testOne    X                 Failed by verification.

显示该插件创建的文件。

disp(fileread(tapFile))
1..3
not ok 1 - ExampleTest/testOne
# ================================================================================
# Verification failed in 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 Information:
#     ------------------
#     In C:\work\ExampleTest.m (ExampleTest.testOne) at 4
# ================================================================================
ok 2 - ExampleTest/testTwo
ok 3 - ExampleTest/testThree

可使用定向到标准输出的 TAPPlugin。不过，显示在标准输出中的任何其他文本（例如失败的测试信息）都会中断流，并可能使其失效。

版本历史记录

在 R2014a 中推出

另请参阅

| |

外部网站