runtests

运行的测试

描述

结果= runtests运行所有的测试在当前文件夹,并返回结果TestResult对象。

例子

结果= runtests (测试)运行一组指定的测试。

例子

结果= runtests (测试,名称,值)运行一组测试由一个或多个指定附加选项名称,值对参数。

例子

全部折叠

创建一个文件夹myExample在你当前的工作目录,改变到文件夹中。

myExample文件夹中,创建一个测试脚本,typeTest.m

% %测试两类经验值=“双”;行动= 1;断言(isa(行动,经验值))% %测试单个类经验值=“单一”;行动= (“单一”);断言(isa(行动,经验值))% %测试uint16类经验值=“uint16”;行动= (“uint16”);断言(isa(行动,经验值))

myExample文件夹中,创建一个测试脚本,sizeValueTest.m

% %测试尺寸经验= 13 [7];行动= 1 (13 [7]);断言(isequal(大小(act),经验值))% %测试值的行动= (42);断言(独特(act) = = 1)

运行所有测试在当前文件夹。

runtests
运行sizeValueTest . .完成sizeValueTest __________运行typeTest……完成typeTest __________ ans = 1 x5 TestResult数组属性:名称传递失败的不完整的时间细节总数:5了,失败了,0不完整,测试时间0.038077秒。

MATLAB®跑了5测试。有两个通过测试sizeValueTest和3通过测试typeTest

创建如下所示的测试文件,并将其保存runtestsExampleTest.m在MATLAB的路径上。

函数测试= runtestsExampleTest测试= functiontests (localfunctions);函数testFunctionOne (testCase)

运行测试。

结果= runtests (“runtestsExampleTest.m”);
runtestsExampleTest运行。完成runtestsExampleTest __________

如果它不存在,创建测试文件,runtestsExampleTest.m在上面的示例。

创建一个文件夹,人体,在那个文件夹,创建以下runtestsExampleSubFolderTest.m文件。

函数测试= runtestsExampleSubFolderTest测试= functiontests (localfunctions);函数testFunctionTwo (testCase)

从上面的文件夹中运行测试人体通过设置“IncludeSubfolders”为true。

结果= runtests (pwd,“IncludeSubfolders”,真正的);
runtestsExampleTest运行。完成运行runtestsExampleSubFolderTest runtestsExampleTest __________。完成runtestsExampleSubFolderTest __________

runtests运行测试在当前文件夹和子文件夹。

如果你不指定“IncludeSubfolders”财产runtests函数,它没有子文件夹中运行测试。

结果= runtests (pwd);
runtestsExampleTest运行。完成runtestsExampleTest __________

创建以下测试文件,并将其保存runInParallelTest.m在你的MATLAB®路径。

函数测试= runInParallelTest测试= functiontests (localfunctions);函数外种皮(testCase) verifyEqual (testCase 5 5);函数的(testCase) verifyTrue (testCase、逻辑(1));函数testC (testCase) verifySubstring (testCase,“SomeLongText”,“长”);函数testD (testCase) verifySize (testCase (2、5、3), [2 5 3]);函数证人(testCase) verifyGreaterThan (testCase 3 2);函数testF (testCase) verifyEmpty (testCase, {},单元阵列不是空的。);函数testG (testCase) verifyMatches (testCase,“一些文本”,“一些(Tt) ext”);

并行运行测试。并行运行测试需要并行计算工具箱™。测试框架可能不同的顺序和数量的组或测试包括每组中。

结果= runtests (“runInParallelTest”,“UseParallel”,真正的);
对比测试分成7组,4上运行他们的工人。- - - - - - - - - - - - - - - - -完成组2 - - - - - - - - - - - - - - - - - runInParallelTest运行。做runInParallelTest __________ - - - - - - - - - - - - - - - - -完成集团3 - - - - - - - - - - - - - - - - - runInParallelTest运行。完成runInParallelTest __________ - - - - - - - - - - - - - - - - -完成组1 - - - - - - - - - - - - - - - - - runInParallelTest运行。完成runInParallelTest __________ - - - - - - - - - - - - - - - - -完成组4 - - - - - - - - - - - - - - - - - runInParallelTest运行。做runInParallelTest __________ - - - - - - - - - - - - - - - - -完成集团6 - - - - - - - - - - - - - - - - - runInParallelTest运行。做runInParallelTest __________ - - - - - - - - - - - - - - - - -完成集团5 - - - - - - - - - - - - - - - - - runInParallelTest运行。做runInParallelTest __________ - - - - - - - - - - - - - - - - -完成集团7 - - - - - - - - - - - - - - - - - runInParallelTest运行。完成runInParallelTest __________

在工作目录中,创建testZeros.m。这个类包含四个测试方法。

classdeftestZeros < matlab.unittest.TestCase属性(TestParameter)类型= {“单一”,“双”,“uint16”};巨大的=结构(“s2d”3 [3],“s3d”,(2 5 4));结束方法(测试)函数testClass (testCase、类型的)testCase.verifyClass(0(巨大、类型),类型);结束函数testSize (testCase,特大号)testCase.verifySize(0(特大号),巨大的);结束函数testDefaultClass (testCase) testCase.verifyClass (0,“双”);结束函数testDefaultSize testCase (testCase)。verifySize (0, [1]);结束函数testDefaultValue (testCase) testCase.verifyEqual (0, 0);结束结束结束

完整的测试套件中有11个测试元素:6的testClass方法2的testSize方法,并从各1人testDefaultClass,testDefaultSize,testDefaultValue方法。

在命令提示符运行所有的参数化testSize方法。

runtests (“testZeros / testSize”)
运行testZeros . .完成testZeros __________ ans = 1 x2 TestResult数组属性:名称传递失败的不完整的时间细节总数:2了,失败了,0不完整,测试时间0.049806秒。

runtests函数的两个参数化测试执行testSize方法。此外,您可以指定测试程序名称runtests (“testZeros”、“ProcedureName”、“testSize”)

运行测试使用的元素巨大的参数属性。

runtests (“testZeros”,“ParameterProperty”,“巨大的”)
运行testZeros ........完成testZeros __________ ans = 1×8 TestResult数组属性:名称传递失败的完整细节总数持续时间:8了,失败了,0不完整,测试时间0.061142秒。

runtests函数执行八个测试使用巨大的参数属性:6的testClass和两个方法testSize方法。

运行测试使用的元素参数名称。

runtests (“testZeros”,“ParameterName”,“单一”)
运行testZeros . .完成testZeros __________ ans = 1 x2 TestResult数组属性:名称传递失败的不完整的时间细节总数:2了,失败了,0不完整,测试时间0.011537秒。

runtests函数的两个测试执行testClass方法使用巨大的参数名称。

输入参数

全部折叠

指定为字符串数组的测试套件,特征向量,或单元阵列特征向量。单元阵列中的每个特征向量可以包含一个测试文件的名称,一个测试类,一个测试套件元素名称,一个包,其中包含您的测试类,一个文件夹包含测试文件,或一个包含测试文件的项目文件夹。

例子:runtests (“ATestFile.m”)

例子:runtests (“ATestFile / aTest”)

例子:runtests (“mypackage.MyTestClass”)

例子:runtests (pwd)

例子:runtests ({pwd‘mypackage.MyTestClass’,‘ATestFile.m’,‘mypackage.subpackage})

例子:runtests (C: /项目/ project1 /)

名称-值对的观点

指定可选的逗号分隔条名称,值参数。的名字参数名称和吗价值相应的价值。的名字必须出现在引号。您可以指定几个名称和值对参数在任何顺序Name1, Value1,…,的家

例子:runtests(测试,“名字”,“productA_ *”)运行测试元素开始的一个名字“productA_”

基础包含文件的文件夹的名称定义测试类、函数或脚本,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,测试元素必须包含在一个指定的文件夹。如果没有一个测试元素匹配基础文件夹,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。测试文件包中定义的基础是顶级包文件夹的父文件夹。

指标应用运行时调试功能测试,指定为真正的(01)。例如,如果遇到一个测试失败,测试执行框架暂停进入调试模式。

数据类型:逻辑

指示器在子文件夹运行测试,指定为真正的(01)。默认情况下,框架在指定的文件夹中运行测试,而不是他们的子文件夹。

数据类型:逻辑

指示器在子包运行测试,指定为真正的(01)。默认情况下,框架运行测试指定的包,但不是在他们的子包。

数据类型:逻辑

指标包括测试引用项目,指定为逻辑真正的。引用项目的更多信息,参见组件化大型项目

数据类型:逻辑

最大冗长水平记录诊断包括测试运行,指定为一个整数值从0到4,或作为一个matlab.unittest.Verbosity枚举对象。的runtests功能包括记录在这个级别及以下的诊断。整数值对应的成员matlab.unittest.Verbosity枚举。

默认情况下runtests包括诊断记录的matlab.unittest.Verbosity.Terse级别(1级)。排除诊断记录,指定LoggingLevel作为Verbosity.None(0级)。

记录诊断是诊断,您提供的测试框架调用日志(TestCase)日志(夹具)方法。

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

任何信息

1 简洁

最小的信息

2 简洁的

适度的信息

3 详细的

一些补充信息

4 详细的

大量的补充信息

显示水平事件细节,指定为一个整数值从0到4,或作为一个matlab.unittest.Verbosity枚举对象。整数值对应的成员matlab.unittest.Verbosity枚举。

runtests函数显示失败和记录事件的细节规定OutputDetail。默认情况下,runtests显示失败和记录事件matlab.unittest.Verbosity.Detailed级别(三级)和测试运行进展matlab.unittest.Verbosity.Concise(要求等级2)水平。

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

任何信息

1 简洁

最小的信息

2 简洁的

适度的信息

3 详细的

一些补充信息

4 详细的

大量的补充信息

套件的名称元素,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,的名字属性的测试元素必须匹配指定的名称之一。如果没有测试的元素有一个匹配的名称,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。

参数名称使用的测试套件元素,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,参数化属性的测试元素必须包含至少一个指定的参数名称。如果没有测试元素匹配的参数名称,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。

名称属性,它定义了一个参数使用的测试套件元素,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,参数化属性的测试元素必须包含至少一个指定的属性名。如果没有测试元素匹配的属性名,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。

测试程序的名称,指定为字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,ProcedureName属性的测试元素必须匹配一个指定程序的名字。如果没有一个测试元素有一个匹配的过程名,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。

在基于类的测试,ProcedureName测试方法的名称。在一个基于函数的测试,它的名字是当地的功能包含测试。在一个基于脚本的测试中,这是一个测试区产生的标题名称。不像的名字,测试程序的名称不包括任何类或包名称或参数化的信息。

路径源代码包含在代码覆盖率报告,指定为一个字符串数组,特征向量,或单元阵列特征向量。使用这个选项runtests运行指定的测试并生成代码覆盖率报告指定的代码文件。报告显示这行源代码执行的测试。

源代码可以绝对或相对路径的一个或多个文件夹或文件。m,.mlx,或.mlapp扩展。

例子:runtests(测试、“ReportCoverageFor”、“mySource.m”)

数据类型:字符|字符串|细胞

当运行指标应用严格的检查测试,指定为真正的(01)。例如,如果一个测试框架会生成一个资格失败发出警告。

数据类型:逻辑

类,测试类的名称来源于,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,TestClass属性的测试元素必须指向一个测试类,它来源于一个指定的类。如果没有测试元素匹配一个类,将返回一个空的测试套件。

使用的测试套件测试标记的名称的元素,指定为一个字符串数组,特征向量,或单元阵列特征向量。这个论点过滤器TestSuite数组元素。的测试框架包括一个测试套件,标签属性的测试元素必须包含至少一个指定的标签名称。如果没有测试元素匹配的标记名称,将返回一个空的测试套件。使用通配符*匹配任意数量的字符。使用问号字符吗?匹配一个字符。

并行运行测试,指标指定为真正的(01)。

默认情况下runtests在连续运行测试。如果你设置UseParallel真正的,然后runtests将测试套件划分为独立的组织和并行运行组如果:

  • 并行计算工具箱安装。

  • 开放平行池存在或自动池创建启用了在并行的偏好。

否则,runtests在串行不管值进行运行测试UseParallel

并行测试可能不兼容其他选项。例如,测试发生在串行“UseParallel”“调试”都设置为true。并联运行时,测试框架可能不同的顺序和数量的组或测试包括每组中。

数据类型:逻辑

扩展功能

介绍了R2013b