matlab.unittest.TestSuite class

Package: matlab.unittest

Class for grouping tests to run

Description

The matlab.unittest.TestSuite class is the fundamental interface used to group and run a set of tests in the unit test framework. The matlab.unittest.TestRunner object can only run arrays of TestSuite objects.

Construction

TestSuite arrays are created using static methods of the TestSuite class. These methods may return subclasses of the TestSuite class depending on the method call and context.

Methods

fromClass	Create suite from TestCase class
fromFile	Create TestSuite array from test file
fromFolder	Create TestSuite array from all tests in folder
fromMethod	Create TestSuite array from single test method
fromName	Create Test object from name of test element
fromPackage	Create TestSuite array from all tests in package
run	Run TestSuite array using TestRunner object configured for text output
selectIf	Select test suite elements that satisfy conditions
sortByFixtures	Reorder test suite based on shared fixtures

Examples

Create Test Suite of Every Type of Test Set

Add the matlab.unittest.TestSuite class to the current import list.

import matlab.unittest.TestSuite;

Create test suites using each method.

fileSuite    = TestSuite.fromFile('SomeTestFile.m'); 
folderSuite  = TestSuite.fromFolder(pwd);
packageSuite = TestSuite.fromPackage('mypackage.subpackage');
classSuite   = TestSuite.fromClass(?mypackage.MyTestClass); 
methodSuite  = TestSuite.fromMethod(?SomeTestClass,'testMethod');

Concatenate the suites.

largeSuite = [fileSuite, folderSuite, packageSuite, classSuite, methodSuite];

Run the full suite.

result = run(largeSuite)