MATLAB Test Manager

Manage MATLAB tests and results for projects

Since R2023a

Description

Use the MATLAB Test Manager to manage tests and test results for projects. You can create and run tests and test suites, view results and failure diagnostics, collect coverage, and view coverage reports. View and verify linked requirements.

To add tests to the test manager:

1. Add a test file to the project. For more information, see Manage Project Files.

2. Add a Test label to the file. For more information, see Add Labels to Project Files.

3. Add tests to the test file. For more information, see Ways to Write Unit Tests.

×

Open the MATLAB Test Manager App

Open a project, then use one of these approaches to open the app:

• MATLAB^® Toolstrip: In the Project tab, in the Tools menu, under Apps, click the MATLAB Test Manager.

• MATLAB command prompt: Enter matlabTestManager.

Examples

Run Tests and Filter Results

Open the MATLABShortestPath project.

openProject("MATLABShortestPath");

Open the MATLAB Test Manager.

matlabTestManager

Run all tests in the project by clicking the Run button . Filter the results to only show the failed tests by clicking the Failed button in the test results summary.

Create and Run Test Suites

Open the MATLABShortestPath project.

openProject("MATLABShortestPath");

Open the MATLAB Test Manager.

matlabTestManager

Open the Test Suite Manager by clicking the drop-down to the left of the Run button and selecting Manage Custom Test Suites. Click New to create a new test suite. Set the Name field to EdgelessTests.

Select Tags and enter EdgelessTests in the text box. Click Save, then click Close.

In the test manager, select the test suite by setting the drop-down to the left of the Run button to EdgelessTests. Run the tests in the test suite by clicking the Run button .

Collect Coverage

Open the MATLABShortestPath project.

openProject("MATLABShortestPath");

Open the MATLAB Test Manager.

matlabTestManager

Click the Coverage button , then select Enable Coverage and set the metric level to MC/DC.

Run all tests in the project by clicking the Run button . View the coverage results by clicking the Report button and, under Coverage Reports, selecting the coverage report.

Customize Test Run

You can customize your test run by using buttons in the toolstrip:

• Parallel execution — To use parallel execution, click the Parallel button .

• Strict checks — To treat warnings as errors, enable strict checks. Click the Settings button , then, in the Test Run Settings dialog box, under Strictness, select Apply strict checks when running tests.

• Output Detail — To specify the detail level for reported events, click the Settings button , then, in the Test Run Settings dialog box, under Output Detail, clear Use Default and set the output detail level.

• Logging Level — To specify the maximum level at which logged diagnostics are included by the plugin instance, click the Settings button , then, in the Test Run Settings dialog box, under Logging Level, clear Use Default and set the logging level.

Note

The MATLAB Test Manager shares test settings with the MATLAB Editor and Test Browser. For more information, see Comparison of Test Settings.

Add, Remove, and Sort Columns

You can add, remove, and sort columns in the Test Details table.

To add and remove columns, click the Column button and select or clear columns.

Note

To add the Requirements column, you must have Requirements Toolbox™ installed.

To sort the table by a column, point to the column, then click the Sort Up button . To reverse sort, click the Sort Down button .

Version History

Introduced in R2023a