matlab.unittest.TestSuite.fromMethod

类: matlab.unittest.TestSuite
命名空间: matlab.unittest

基于单一测试方法创建测试套件

全页展开

语法

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod)
suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,selector)
suite = matlab.unittest.TestSuite.fromMethod(___,Name,Value)

说明

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod) 基于 testClass 中包含的指定 Test 方法创建一个测试套件，并以 matlab.unittest.TestSuite 数组形式返回该测试套件。

当您调用方法来创建测试套件以及当您运行生成的测试套件时，testClass 必须在路径中。

示例

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,selector) 仅包含满足指定选择器条件的测试。

示例

suite = matlab.unittest.TestSuite.fromMethod(___,Name,Value) 支持上述语法中的输入参量组合，且可使用一个或多个名称-值参量指定选项。例如，suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,"ParameterName","double") 基于指定的 Test 方法创建一个测试套件，该套件仅包括使用名为 "double" 的参数的测试。

示例

输入参数

全部展开

测试类，指定为 matlab.metadata.Class 实例。testClass 必须从 matlab.unittest.TestCase 类派生。

示例: ?MyClass

Test 方法，指定为字符串标量、字符向量或 matlab.metadata.Method 实例。该方法必须在具有 Test 属性的 methods 块中定义。

选择器，指定为 matlab.unittest.selectors.Selector 对象。

示例: matlab.unittest.selectors.HasTag

名称-值参数

全部展开

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

示例: suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,ParameterName="double")

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,"ParameterName","double")

要在测试中使用的外部参数，指定为由 matlab.unittest.parameters.Parameter 对象组成的数组。使用此参量指定外部参数，而不是参数化测试中的现有参数。有关详细信息，请参阅在参数化测试中使用外部参数。

包含测试文件的基本文件夹的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素必须包含在 BaseFolder 指定的基本文件夹之一中。如果没有 Test 元素与基本文件夹匹配，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

对于命名空间中定义的测试文件，基本文件夹是顶级命名空间文件夹的父级。

包含源代码的文件和文件夹的名称，指定为字符串向量、字符向量或字符向量元胞向量。此参量通过仅包括依赖指定源代码的测试来过滤测试套件。如果没有测试依赖源代码，则返回空测试套件。

指定的值必须表示至少一个现有文件。如果指定文件夹，框架将提取该文件夹中文件的路径。

您必须有 MATLAB® Test™ 许可证才能使用 DependsOn。有关通过源代码依赖关系选择测试的详细信息，请参阅 matlabtest.selectors.DependsOn (MATLAB Test)。

示例: DependsOn=["myFile.m" "myFolder"]

示例: DependsOn=["folderA" "C:\work\folderB"]

测试的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Name 属性必须匹配 Name 指定的名称之一。如果 Test 元素都没有匹配的名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

对于一个给定的测试文件，测试的名称唯一地标识测试内容的最小可运行部分。测试名称包括命名空间名称、文件名（不包括扩展名）、过程名称和关于参数化的信息。

定义测试使用的参数的测试类属性的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Parameterization 属性必须包含 ParameterProperty 指定的至少一个属性名称。如果 Test 元素都没有匹配的属性名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

测试使用的参数的名称，指定为字符串数组、字符向量或字符向量元胞数组。MATLAB 根据定义参数的测试类属性生成参数名称。例如：

  • 如果属性值是元胞数组，则 MATLAB 根据元胞数组元素的值、类型和维度，基于元胞数组的元素生成参数名称。

  • 如果属性值是结构体，则 MATLAB 将根据结构体字段生成参数名称。

ParameterName 参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Parameterization 属性必须包含 ParameterName 指定的至少一个参数名称。如果 Test 元素都没有匹配的参数名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

测试过程的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 ProcedureName 属性必须匹配 ProcedureName 指定的过程名称之一。如果 Test 元素都没有匹配的过程名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

在基于类的测试中，测试过程的名称是包含该测试的 Test 方法的名称。在基于函数的测试中，它是包含测试的局部函数的名称。在基于脚本的测试中，它是从测试部分标题生成的名称。与测试套件元素的名称不同，测试过程的名称不包括任何命名空间名称、文件名或关于参数化的信息。

派生测试类的父类的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 TestClass 属性必须指向从 Superclass 指定的类之一派生的一个测试类。如果没有 Test 元素与类匹配，将返回空测试套件。

测试使用的标记的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参量过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Tags 属性必须包含 Tag 指定的至少一个标记名称。如果 Test 元素都没有匹配的标记名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

属性

Statictrue

要了解方法的属性，请参阅方法属性。

示例

全部展开

打开实时脚本

使用 fromMethod 静态方法基于 Test 方法创建测试套件。

在当前文件夹中名为 ZerosTest.m 的文件中，创建 ZerosTest 类来测试 zeros 函数。

classdef ZerosTest < matlab.unittest.TestCase
    properties (TestParameter)
        type = {'single','double','uint16'};
        size = struct("s2d",[3 3],"s3d",[2 5 4]);
    end
    
    methods (Test)
        function testClass(testCase,size,type)
            testCase.verifyClass(zeros(size,type),type)
        end
        
        function testSize(testCase,size)
            testCase.verifySize(zeros(size),size)
        end
        
        function testDefaultClass(testCase)
            testCase.verifyClass(zeros,"double")
        end

        function testDefaultSize(testCase)
            testCase.verifySize(zeros,[1 1])
        end
        
        function testDefaultValue(testCase)
            testCase.verifyEqual(zeros,0)
        end
    end
end

导入此示例中使用的类。

import matlab.unittest.TestSuite
import matlab.unittest.selectors.HasParameter

基于 testClass 方法创建一个测试套件，并显示测试名称。该套件包含六个参数化的 Test 元素。

suite = TestSuite.fromMethod(?ZerosTest,"testClass");
disp({suite.Name}')
    {'ZerosTest/testClass(size=s2d,type=single)'}
    {'ZerosTest/testClass(size=s2d,type=double)'}
    {'ZerosTest/testClass(size=s2d,type=uint16)'}
    {'ZerosTest/testClass(size=s3d,type=single)'}
    {'ZerosTest/testClass(size=s3d,type=double)'}
    {'ZerosTest/testClass(size=s3d,type=uint16)'}

基于 testClass 方法创建一个测试套件，该套件只包括使用名为 "double" 的参数的测试。

suite1 = TestSuite.fromMethod(?ZerosTest,"testClass", ...
    HasParameter("Name","double"));
disp({suite1.Name}')
    {'ZerosTest/testClass(size=s2d,type=double)'}
    {'ZerosTest/testClass(size=s3d,type=double)'}

基于 testClass 方法创建一个测试套件，该套件只包括其名称中包含 "3" 的测试。

suite2 = TestSuite.fromMethod(?ZerosTest,"testClass","Name","*3*");
disp({suite2.Name}')
    {'ZerosTest/testClass(size=s3d,type=single)'}
    {'ZerosTest/testClass(size=s3d,type=double)'}
    {'ZerosTest/testClass(size=s3d,type=uint16)'}

版本历史记录

在 R2013a 中推出

全部展开

另请参阅

函数

命名空间