matlab.unittest.plugins.TestRunProgressPlugin Class
Namespace: matlab.unittest.plugins
Superclasses: matlab.unittest.plugins.TestRunnerPlugin
, matlab.unittest.plugins.Parallelizable
Plugin that displays test run progress
Description
The matlab.unittest.plugins.TestRunProgressPlugin
class provides a plugin that displays test run progress.
You can use the plugin to control the amount of text output displayed during a test run as
well as the location of the text output.
The matlab.unittest.plugins.TestRunProgressPlugin
class is a handle
class.
Creation
To create a TestRunProgressPlugin
instance, use the withVerbosity
static method.
Methods
matlab.unittest.plugins.TestRunProgressPlugin.withVerbosity | Create plugin that displays test run progress at specified verbosity |
Examples
Run tests and control the amount of information to display by using the
TestRunProgressPlugin
class.
In a file named cylinderPlotTest.m
in your current folder, create
function-based tests to test a cylinder plot.
function tests = cylinderPlotTest tests = functiontests(localfunctions); end function setupOnce(testCase) testCase.TestData.Figure = figure; addTeardown(testCase,@close,testCase.TestData.Figure) end function setup(testCase) testCase.TestData.Axes = axes("Parent",testCase.TestData.Figure); addTeardown(testCase,@clf,testCase.TestData.Figure) cylinder(testCase.TestData.Axes,10) end function testXLim(testCase) xlim = testCase.TestData.Axes.XLim; verifyLessThanOrEqual(testCase,xlim(1),-10) verifyGreaterThanOrEqual(testCase,xlim(2),10) end function zdataTest(testCase) s = findobj(testCase.TestData.Axes,"Type","surface"); verifyEqual(testCase,min(s.ZData(:)),0) verifyEqual(testCase,max(s.ZData(:)),1) end
Import the TestRunProgressPlugin
class.
import matlab.unittest.plugins.TestRunProgressPlugin
Create a test suite from the test file.
suite = testsuite("cylinderPlotTest.m");
Run the tests using a default test runner. The test runner displays test run progress at
the matlab.automation.Verbosity.Concise
level (level 2).
runner = testrunner; results = runner.run(suite);
Running cylinderPlotTest .. Done cylinderPlotTest __________
Create a new test runner and configure it using a plugin that displays test run progress
at the matlab.automation.Verbosity.Terse
level (level 1). Then, rerun the
tests using the test runner.
runner = testrunner("minimal"); plugin = TestRunProgressPlugin.withVerbosity("Terse"); runner.addPlugin(plugin) results = runner.run(suite);
..
Rerun the tests and display test run progress at the
matlab.automation.Verbosity.Verbose
level (level 4), which is the highest
verbosity level.
runner = testrunner("minimal"); plugin = TestRunProgressPlugin.withVerbosity("Verbose"); runner.addPlugin(plugin) results = runner.run(suite);
Running cylinderPlotTest Setting up cylinderPlotTest Evaluating TestClassSetup: setupOnce Done setting up cylinderPlotTest in 0.093533 seconds Running cylinderPlotTest/testXLim Evaluating TestMethodSetup: setup Evaluating Test: testXLim Evaluating TestMethodTeardown: teardown Evaluating addTeardown function: clf Done cylinderPlotTest/testXLim in 0.15021 seconds Running cylinderPlotTest/zdataTest Evaluating TestMethodSetup: setup Evaluating Test: zdataTest Evaluating TestMethodTeardown: teardown Evaluating addTeardown function: clf Done cylinderPlotTest/zdataTest in 0.028826 seconds Tearing down cylinderPlotTest Evaluating TestClassTeardown: teardownOnce Evaluating addTeardown function: close Done tearing down cylinderPlotTest in 0.018563 seconds Done cylinderPlotTest in 0.29114 seconds __________
Control the verbosity level and location to display test run progress
information by using the TestRunProgressPlugin
class.
In a file named ExampleTest.m
in your current folder, create
the ExampleTest
test class.
classdef ExampleTest < matlab.unittest.TestCase methods (Test) function testOne(testCase) % Test fails testCase.verifyEqual(5,4) end function testTwo(testCase) % Test passes testCase.verifyEqual(5,5) end end end
Import the classes used in this example.
import matlab.unittest.plugins.TestRunProgressPlugin import matlab.automation.streams.ToFile
Create a test suite from the ExampleTest
class.
suite = testsuite("ExampleTest");
Using a TestRunProgressPlugin
instance, run the tests and display
test run progress at the matlab.automation.Verbosity.Detailed
level
(level 3). By default, the plugin directs its text output to the screen.
runner = testrunner("minimal"); plugin = TestRunProgressPlugin.withVerbosity("Detailed"); runner.addPlugin(plugin) results = runner.run(suite);
Running ExampleTest Setting up ExampleTest Done setting up ExampleTest in 0 seconds Running ExampleTest/testOne Done ExampleTest/testOne in 0.54909 seconds Running ExampleTest/testTwo Done ExampleTest/testTwo in 0.011 seconds Tearing down ExampleTest Done tearing down ExampleTest in 0 seconds Done ExampleTest in 0.56009 seconds __________
Create a new test runner and configure it using a plugin that directs its output
to a file named myOutput.log
in your current folder. If you rerun
the tests, the information on test run progress no longer appears in the Command
Window. The plugin directs the text output to the specified file instead of the
screen.
runner = testrunner("minimal"); plugin = TestRunProgressPlugin.withVerbosity( ... "Detailed",ToFile("myOutput.log")); runner.addPlugin(plugin) results = runner.run(suite);
Display the contents of the file created by the plugin.
disp(fileread("myOutput.log"))
Running ExampleTest Setting up ExampleTest Done setting up ExampleTest in 0 seconds Running ExampleTest/testOne Done ExampleTest/testOne in 0.051384 seconds Running ExampleTest/testTwo Done ExampleTest/testTwo in 0.0099046 seconds Tearing down ExampleTest Done tearing down ExampleTest in 0 seconds Done ExampleTest in 0.061288 seconds __________
Version History
Introduced in R2014b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Sélectionner un site web
Choisissez un site web pour accéder au contenu traduit dans votre langue (lorsqu'il est disponible) et voir les événements et les offres locales. D’après votre position, nous vous recommandons de sélectionner la région suivante : .
Vous pouvez également sélectionner un site web dans la liste suivante :
Comment optimiser les performances du site
Pour optimiser les performances du site, sélectionnez la région Chine (en chinois ou en anglais). Les sites de MathWorks pour les autres pays ne sont pas optimisés pour les visites provenant de votre région.
Amériques
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)