matlab.unittest.plugins.QualifyingPlugin class

Пакет: matlab.unittest.plugins
Суперклассы: matlab.unittest.plugins.TestRunnerPlugin

Интерфейс для плагинов, которые выполняют общесистемные проверки

Описание

Используйте соответствующие плагины, чтобы создать непройденные тесты помимо вашего содержания теста. Квалификация на уровне плагина полезна, потому что вы можете избежать повторения одной и той же проверки в каждом тесте. Можно принять решение периодически применять общесистемные проверки к тестовому набору, просто добавив плагин к исполнителю тестов для определенного тестового сеанса.

The QualifyingPlugin интерфейс позволяет авторам плагинов исполнитель тестов реализовывать плагины, которые выполняют общесистемные проверки на тестовом наборе. Можно выполнить верификации, допущения, утверждения и критические утверждения в этих унаследованных методах:

setupTestClass
teardownTestClass
setupTestMethod
teardownTestMethod

Можно выполнить только предположения, утверждения и критические утверждения в этих унаследованных методах:

setupSharedTestFixture
teardownSharedTestFixture

Методы

assertUsing	Утверждайте, что значение удовлетворяет заданному ограничению
assumeUsing	Предположим, что значение удовлетворяет заданному ограничению
fatalAssertUsing	Фатально утверждайте, что значение удовлетворяет заданному ограничению
verifyUsing	Проверьте, что значение удовлетворяет заданному ограничению

Унаследованные методы

createSharedTestFixture	Расширение создания общих образцов испытательного стенда
createTestClassInstance	Расширение создания `TestCase` уровня классов образцы
createTestMethodInstance	Расширение создания `TestCase` уровня метода образцы
reportFinalizedResult	Включите отчетность по окончательным результатам тестирования
reportFinalizedSuite	Расширение отчетности по завершенным `TestSuite` массив
runSession	Расширение выполнения тестового сеанса
runTest	Расширение выполнения одиночного `Test` элемент
runTestClass	Расширение работы `Test` элементы из того же класса или функции
runTestMethod	Расширение выполнения одиночного метода тестирования
runTestSuite	Расширение работы `TestSuite` массив
setupSharedTestFixture	Расширение настройки общего испытательного стенда
setupTestClass	Расширение настройки тестового класса
setupTestMethod	Расширьте настройку метода тестирования
teardownSharedTestFixture	Удлините разрывание общего испытательного стенда
teardownTestClass	Расширение тестового класса отключения
teardownTestMethod	Удлините метод испытания на разрыв

Копировать семантику

Указатель. Чтобы узнать, как классы handle влияют на операции копирования, см. раздел «Копирование объектов».

Примеры

свернуть все

Тест с использованием проверки в плагине

Создайте плагин, чтобы убедиться, что тестовые файлы покидают MATLAB^® путь не изменяется. Если путь после запуска тестового файла отличается от начального пути, тест завершается неуспешно.

Создайте класс, VerifyNoPathChangePlugin, который наследует от matlab.unittest.plugins.QualifyingPlugin класс.

classdef VerifyNoPathChangePlugin < matlab.unittest.plugins.QualifyingPlugin
    properties (Access=private)
        OriginalPath
    end
    
    methods (Access=protected)
        function setupTestClass(plugin, pluginData)
            plugin.OriginalPath = path;
            setupTestClass@matlab.unittest.plugins.QualifyingPlugin(plugin,pluginData);
        end
        function teardownTestClass(plugin, pluginData)
            import matlab.unittest.constraints.IsEqualTo;
            teardownTestClass@matlab.unittest.plugins.QualifyingPlugin(plugin,pluginData);
            plugin.verifyUsing(pluginData.QualificationContext, ...
                path, IsEqualTo(plugin.OriginalPath), ...
                sprintf('%s modified the path.', pluginData.Name));
        end
    end
end

Создайте следующий класс тестирования. Тест изменяет путь, но не восстанавливает исходный путь.

classdef LeavesModifiedPath < matlab.unittest.TestCase
    methods (Test)
        function test1(~)
            addpath(pwd);
        end
    end
end

В целях этого примера в командной строке удалите текущую рабочую папку из пути.

rmpath(pwd)

Создайте тестовый набор, добавьте плагин к исполнителю тестов и запустите набор. Тест завершается неуспешно, поскольку путь после теста отличается от начального пути.

suite = matlab.unittest.TestSuite.fromClass(?LeavesModifiedPath);
runner = matlab.unittest.TestRunner.withTextOutput;
runner.addPlugin(VerifyNoPathChangePlugin);
runner.run(suite);

Running LeavesModifiedPath
.
================================================================================
Verification failed while setting up or tearing down LeavesModifiedPath.
As a result, all LeavesModifiedPath tests failed.

    ----------------
    Test Diagnostic:
    ----------------
    LeavesModifiedPath modified the path.

    ---------------------
    Framework Diagnostic:
    ---------------------
    IsEqualTo failed.
    --> StringComparator failed.
        --> The character arrays are not equal.
    
    Actual char:
        C:\work;C:\Program Files\MATLAB\R2015b\toolbox\matlab\...
   Expected char:
        C:\Program Files\MATLAB\R2015b\toolbox\matlab\...

    ------------------
    Stack Information:
    ------------------
    In C:\work\VerifyNoPathChangePlugin.m (VerifyNoPathChangePlugin.teardownTestClass) at 14
================================================================================

Done LeavesModifiedPath
__________

Failure Summary:

     Name                      Failed  Incomplete  Reason(s)
    =======================================================================
     LeavesModifiedPath/test1    X                 Failed by verification.

См. также

matlab.unittest.plugins.FailOnWarningsPlugin | matlab.unittest.plugins.plugindata.QualificationContext | matlab.unittest.plugins.TestRunnerPlugin

Темы

Введенный в R2015b

Документация