sltest.plugins.ToTestManagerLog Class

Namespace: sltest.plugins

Output stream to write text to Test Manager result Logs for MATLAB-based Simulink tests

Since R2020b

Description

The sltest.plugins.ToTestManagerLog creates and writes a text output stream of log information to the Logs section of test results in the Test Manager for the current TestCaseResult. Use this plugin with the matlab.unittest.plugins.DiagnosticsOutputPlugin. The ToTestManagerLog plugin generates output only for MATLAB-based Simulink tests, which are derived from sltest.TestCase objects.

The sltest.plugins.ToTestManagerLog class is a handle class.

Creation

Use matlab.sltest.plugins.ToTestMangerLog() with the matlab.unittest.plugins.DiagnosticsOutputPlugin to write the diagnostics output to the Test Manager logs. For example,

runner.addPlugin(DiagnosticsOutputPlugin...
   (ToTestManagerLog());

Examples

collapse all

Write MATLAB-Based Simulink Test Log Information to the Test Manager

Import the needed plugins and the test runner.

 import matlab.unittest.TestRunner
 import matlab.unittest.plugins.DiagnosticsOutputPlugin
 import sltest.plugins.MATLABTestCaseIntegrationPlugin
 import sltest.plugins.ToTestManagerLog

Create a TestSuite array and basic TestRunner object for a test script file, such as one named mySltestTestCaseFile.m.
```
 suite = testsuite('mySltestTestCaseFile.m');
 runner = TestRunner.withNoPlugins;
  
```
Add a MATLABTestCaseIntegrationPlugin to the TestRunner object.
```
 runner.addPlugin(MATLABTestCaseIntegrationPlugin);
```
Run the test suite to add the failing diagnostics and simulation results to the Test Manager.
```
 results = runner.run(suite);
```

Add the passing diagnostics to the Logs section of the test results in the Test Manager.

runner.addPlugin(DiagnosticsOutputPlugin(ToTestManagerLog(),...
   'IncludingPassingDiagnostics',true));

Rerun the suite to add the diagnostics and simulation results to the Test Manager.
```
results = runner.run(suite);
```

Version History

Introduced in R2020b