run

Class: sltest.testmanager.TestSuite
Package: sltest.testmanager

Run test cases in test suite

Syntax

resultObj = run(ts)
resultObj = run(ts,Name,Value)


Description

resultObj = run(ts) runs the enabled test cases in the test suite.

resultObj = run(ts,Name,Value) uses additional options specified by one or more name-value arguments.

Input Arguments

ts — Test suite

sltest.testmanager.TestSuite object

Test suite with the test cases you want to run, specified as an sltest.testmanager.TestSuite object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Parallel=true,Tags=["safety","regression"]

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "Parallel",true,"Tags",["safety","regression"]

Parallel — Whether to run with parallel computing

false (default) | true

Whether to run tests with Parallel Computing Toolbox™ or MATLAB^® Parallel Server™, specified as either false or true. Requires Parallel Computing Toolbox or MATLAB Parallel Server license, respectively.

Example: run(ts,"Parallel",true)

Data Types: logical

Tags — Run only tests with specified tags

string array | cell array of character vectors

Specifies test tags for execution. For more information, see Tags.

Example: run(ts,"Tags",["safety"])

Example: run(ts,"Tags",["safety","regression"])

Data Types: cell | char | string

Output Arguments

resultObj — Result set object

sltest.testmanager.ResultSet object

Test results, returned as a sltest.testmanager.ResultSet results set object.

Examples

Run a Test Suite

Open the model for this example.

openExample('sldemo_autotrans');

Create the test file, test suite, and test case structure.

tf = sltest.testmanager.TestFile("API Test File");
ts = createTestSuite(tf,"API Test Suite");
tc = createTestCase(ts,"simulation","Simulation Test Case");

Remove the default test suite.

tsDel = getTestSuiteByName(tf,"New Test Suite 1");
remove(tsDel);

Assign the system under test to the test case.

setProperty(tc,"Model","sldemo_autotrans");

Run the test suite and return the results data.

ro = run(ts);

Run the Test Suite with Parallel Computing Toolbox

Open the model for this example.

openExample('sldemo_autotrans');

Create the test file, test suite, and test case structure.

tf = sltest.testmanager.TestFile("API Test File");
ts = createTestSuite(tf,"API Test Suite");
tc = createTestCase(ts,"simulation","Simulation Test Case");

Remove the default test suite.

tsDel = getTestSuiteByName(tf,"New Test Suite 1");
remove(tsDel);

Assign the system under test to the test case.

setProperty(tc,"Model","sldemo_autotrans");

Run the test suite with Parallel Computing Toolbox and return the results data.

ro = run(ts,"Parallel",true);

Version History

Introduced in R2015b