主要内容

matlab.unittest.TestRunnerclass

包:matlab.unittest

类的运行测试matlab.unittest框架

描述

matlab.unittest.TestRunner类的基本API用于运行测试套件matlab.unittest框架。它运行和操作TestSuite数组。使用这个类来定制运行测试。

matlab.unittest.TestRunner类是一个处理类。

类属性

密封
真正的

类属性的信息,请参阅类属性

创建

创建一个简单的,沉默TestRunner对象,调用withNoPlugins静态方法。

跑步者= matlab.unittest.TestRunner.withNoPlugins;

创建一个TestRunner对象从MATLAB运行测试®命令窗口,调用withTextOutput静态方法。

跑步者= matlab.unittest.TestRunner.withTextOutput;

创建一个定制的TestRunner对象,调用addPlugin方法。

跑步者= matlab.unittest.TestRunner.withNoPlugins;runner.addPlugin (SomePlugin ())

属性

全部展开

测试运行构件存储根目录,指定为一个字符串标量或特征向量。默认情况下,价值的ArtifactsRootFolder是值字符串(tempdir),但是您可以将它设置为可写的任何文件夹。

在测试运行中产生的任何工件存储在一个文件夹内ArtifactsRootFolder。子文件夹名称是一个独特的标识符与特定的测试运行。MATLAB创建一个子文件夹只有在测试运行产生的工件。

例如,假设ArtifactsRootFolder被设置为“C: \ Temp”和自动生成标识符是测试运行“1231 df38 - 7515 - 4 - dbe a869 c3d9f885f379”。如果一个测试运行产生的工件,“artifact.txt”,存储为工件“C: \ Temp \ 1231 df38 - 7515 - 4 - dbe a869 c3d9f885f379 \ artifact.txt”

装置设置在测试运行器外,指定为一个标量或行向量matlab.unittest.fixtures.Fixture实例。使用这个属性来指定环境配置自动手动执行,而不是在夹具安装和拆卸。

测试运行器认为这些设备已经设置和从未试图建立或拆除任何指定的设备PrebuiltFixtures财产。如果一个测试套件需要一个共享的测试夹具,测试夹具被指定为一个预先构建的夹具,测试运行器不执行设置或拆除行动。

请注意

测试运行器使用一个预先构建的夹具只有指定的PrebuiltFixtures房地产和被列为SharedTestFixture在测试类中定义。测试运行器不使用一个预先构建的夹具夹具是否注册使用TestCase.applyFixture方法。

方法

全部展开

例子

全部折叠

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

进口matlab.unittest.TestRunner进口matlab.unittest.TestSuite

创建一个TestSuite数组中。

套件= TestSuite.fromClass (? mypackage.MyTestClass);

创建TestRunner对象和运行套件。

跑步者= TestRunner.withTextOutput;结果=跑(跑、套房);

这个例子使用一个共享的测试夹具,然后指定预先构建的夹具。测试运行器不建立和拆除预先构建的夹具。自测试假设固定存在,您必须手动执行夹具通常执行的设置工作。

在一个文件中创建一个测试类工作目录。使用一个测试类PathFixture作为一个共享的测试夹具。这个例子假设子文件夹,helperFiles,存在于你的工作文件夹。

classdef(SharedTestFixtures = {matlab.unittest.fixtures.PathFixture (“helperFiles”)})SampleTest < matlab.unittest.TestCase方法(测试)函数test1 (testCase) f = testCase.getSharedTestFixtures;进口matlab.unittest.constraints.ContainsSubstringtestCase.assertThat(路径,ContainsSubstring (f.Folder))结束结束结束

创建一个测试套件和测试运行器在命令提示符。

进口matlab.unittest.TestRunner进口matlab.unittest.TestSuite套件= TestSuite.fromClass (? SampleTest);跑步者= TestRunner.withTextOutput;

运行测试使用共享测试夹具。在这种情况下,夹具不是预先构建的。

runner.run(套);
设置PathFixture完成设置PathFixture:添加“C: \ \ helperFiles工作”的道路。__________ SampleTest运行。完成SampleTest __________拆除PathFixture完成拆除PathFixture:恢复原状之路。__________

测试运行器设置与眼泪下来共享测试夹具。

夹具的创建一个实例,并将它添加到测试运行器。

f = matlab.unittest.fixtures.PathFixture (“helperFiles”);跑步者。PrebuiltFixtures = f;

手动添加“helperFiles”文件夹路径。的PathFixture将指定的文件夹添加到您的路径和测试设置依赖于此行动。然而,由于夹具被定义为预先构建的,测试运行器不执行设置或拆除行动,你必须手动执行它们。在这种情况下,如果你不手动将它添加到您的路径,测试失败。

p = fullfile (pwd,“helperFiles”);在媒介=目录(p);

运行测试。

runner.run(套);
SampleTest运行。完成SampleTest __________

夹具的测试运行器假设是预先构建的,不设置它或把它拆掉。

手动重置你的路。

路径(媒介)

版本历史

介绍了R2013a