Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

matlab.unittest.TestSuite.fromClass

类: matlab.unittest.TestSuite
包: matlab.unittest

根据 TestCase 类创建套件

说明

示例

suite = matlab.unittest.TestSuite.fromClass(testClass) 根据 testClass 中包含的所有 Test 方法创建 TestSuite 数组,并在 suite 中返回该数组。

示例

suite = matlab.unittest.TestSuite.fromClass(testClass,s) 根据 testClass 中包含的所有 Test 方法创建 TestSuite 数组,这些方法满足选择器 s 指定的条件。

示例

suite = matlab.unittest.TestSuite.fromClass(___,Name,Value) 使用由一个或多个 Name,Value 对组参数指定的其他选项创建 TestSuite 数组。您可以将此语法与前面语法中的任何输入参数结合使用。

输入参数

testClass

包含测试方法的类,指定为 meta.class 实例。使用 ? 运算符可创建 meta.class 实例。testClass 必须派生自 matlab.unittest.TestCase

s

选择器,指定为来自 matlab.unittest.selector 包的类的实例。

名称-值对组参数

BaseFolder

包含用于定义测试类或函数的文件的顶层包文件夹父级的名称,指定为字符串数组、字符向量或字符向量元胞数组。此参数筛选 TestSuite 数组元素。要使测试框架包含套件中的一个测试,Test 元素必须包含在 BaseFolder 指定的基本文件夹之一中。如果没有 Test 元素与基本文件夹匹配,将返回空测试套件。使用通配符 * 以匹配任何数量的字符。使用问号字符 ? 只匹配一个字符。

ExternalParameters

用于参数化测试的 matlab.unittest.parameters.Parameter 实例的数组。框架使用这些外部参数代替在参数化测试中定义的对应参数。有关详细信息,请参阅在参数化测试中使用外部参数

Name

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

ParameterProperty

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

ParameterName

测试套件元素使用的参数的名称,指定为字符串数组、字符向量或字符向量元胞数组。MATLAB® 根据定义参数的测试类属性生成参数名称:

  • 如果属性值是字符向量元胞数组,MATLAB 将根据元胞数组中的值生成参数名称。否则,MATLAB 将参数名称指定为 value1value2、…、valueN

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

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

ProcedureName

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

在基于类的测试中,ProcedureName 是测试方法的名称。在基于函数的测试中,它是包含测试的局部函数的名称。在基于脚本的测试中,它是从测试部分标题生成的名称。与 Name 不同的是,测试过程的名称不包括任何类或包名称或有关参数化的信息。

Superclass

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

Tag

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

输出参数

suite

测试集,指定为 matlab.unittest.Test 数组。

属性

Statictrue

要了解方法的属性,请参阅方法属性

示例

全部展开

matlab.unittest.TestSuite 类添加到当前导入列表。

import matlab.unittest.TestSuite;
suite = TestSuite.fromClass(?mypackage.MyTestClass);
result = run(suite)

matlab.unittest.TestSuite 类添加到当前导入列表。

import matlab.unittest.TestSuite;
suite = TestSuite.fromClass(?MyTestClass);
result = run(suite)

在您的工作文件夹中,创建以下 testZeros.m 测试文件。该类包含四种测试方法。

classdef testZeros < matlab.unittest.TestCase
    properties (TestParameter)
        type = {'single','double','uint16'};
        outSize = struct('s2d',[3 3], 's3d',[2 5 4]);
    end
    
    methods (Test)
        function testClass(testCase, type, outSize)
            testCase.verifyClass(zeros(outSize,type), type);
        end
        
        function testSize(testCase, outSize)
            testCase.verifySize(zeros(outSize), outSize);
        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

测试类包含两种参数化测试方法:testClasstestSize

在命令提示符下,基于用于测试 'double' 数据类型的测试元素创建测试套件。

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

suite = TestSuite.fromClass(?testZeros, ...
    HasParameter('Property','type','Name','double'));
{suite.Name}'
ans = 

    'testZeros/testClass(type=double,outSize=s2d)'
    'testZeros/testClass(type=double,outSize=s3d)'

基于以前的示例创建 testZeros.m 类。

在命令提示符下,基于用于测试 'double' 数据类型的测试元素创建测试套件。

import matlab.unittest.TestSuite;

suite = TestSuite.fromClass(?testZeros, ...
    'ParameterProperty','type', 'ParameterName','double');
{suite.Name}'
ans = 

    'testZeros/testClass(type=double,outSize=s2d)'
    'testZeros/testClass(type=double,outSize=s3d)'

提示

  • 使用此方法创建 suite 以及运行 suite 时,testClass 必须位于 MATLAB 路径上。

在 R2013a 中推出