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

Фиксаторы для Setup и кода отключения

При записи тестов используйте метод TestCase.applyFixture, чтобы обработать настройку и код отключения для действий, таких как:

Они fixtures занимают место ручного кодирования действий в setupOnce, teardownOnce, setup и функциях teardown вашего функционального теста.

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

function setup(testCase)
% store current folder
testCase.TestData.origPath = pwd;

% create temporary folder
testCase.TestData.tmpFolder = ['tmpFolder' datestr(now,30)];
mkdir(testCase.TestData.tmpFolder)

% change to temporary folder
cd(testCase.TestData.tmpFolder)
end

function teardown(testCase)
% change to original folder
cd(testCase.TestData.origPath)

% delete temporary folder
rmdir(testCase.TestData.tmpFolder)
end

Однако также можно использовать фиксатор, чтобы заменить обе из тех функций только с измененной функцией setup. Фиксатор хранит информацию, необходимую, чтобы восстановить начальное состояние, и выполняет действия отключения.

function setup(testCase)
% create temporary folder
f = testCase.applyFixture(matlab.unittest.fixtures.TemporaryFolderFixture);

% change to temporary folder
testCase.applyFixture(matlab.unittest.fixtures.CurrentFolderFixture(f.Folder));
end

Тестирование журналирования и многословия

Ваши тестовые функции могут использовать метод TestCase.log. По умолчанию исполнитель тестов сообщает о диагностике, регистрируемой на уровне 1 многословия (Terse). Используйте метод LoggingPlugin.withVerbosity, чтобы ответить на сообщения других уровней многословия. Создайте объект TestRunner, добавьте LoggingPlugin и запустите комплект с методом TestRunner.run. Для получения дополнительной информации о создании исполнителя тестов смотрите Индивидуальную настройку Исполнителя тестов.

Создание тестового набора

Вызов вашего функционального теста возвращает комплект объектов Test. Также можно использовать функцию testsuite или метод TestSuite.fromFile. Если вы хотите конкретный тест, и вы знаете тестовое имя, можно использовать TestSuite.fromName. Если вы хотите создать комплект из всех тестов в конкретной папке, можно использовать TestSuite.fromFolder.

Тестирование выбора

С явным тестовым набором используйте селекторы, чтобы совершенствовать ваш комплект. Несколько из селекторов применимы только для основанных на классах тестов, но можно выбрать тесты для комплекта на основе тестового имени:

Используйте эти подходы в методе генерации комплекта, такие как fromFile, или создайте комплект и отфильтруйте его с помощью метода TestSuite.selectIf. Например, в этом листинге, четыре значения suite эквивалентны.

import matlab.unittest.selectors.HasName
import matlab.unittest.constraints.ContainsSubstring
import matlab.unittest.TestSuite.fromFile

f = 'rightTriTolTest.m';
selector = HasName(ContainsSubstring('Triangle'));

% fromFile, name-value pair
suite = TestSuite.fromFile(f,'Name','*Triangle*')

% fromFile, selector
suite = TestSuite.fromFile(f,selector)

% selectIf, name-value pair
fullSuite = TestSuite.fromFile(f);
suite = selectIf(fullSuite,'Name','*Triangle*')

% selectIf, selector
fullSuite = TestSuite.fromFile(f);
suite = selectIf(fullSuite,selector)

При использовании один из методов создания комплекта с селектором или парой "имя-значение", среда тестирования создает отфильтрованный комплект. При использовании метод TestSuite.selectIf, среда тестирования создает полный тестовый набор и затем фильтрует его. Для больших тестовых наборов этот подход может иметь последствия производительности.

Тестовое выполнение

Существует несколько способов запустить функциональный тест.

Для получения дополнительной информации смотрите Запущенные Тесты для Различных Рабочих процессов.

Программируемый доступ диагностического теста

Если при запуске тесты с функцией runtests или методом run TestSuite или TestCase, среда тестирования использует плагин DiagnosticsRecordingPlugin, который записывает диагностику на результатах испытаний.

После того, как вы запустите тесты, можно получить доступ к зарегистрированной диагностике через поле DiagnosticRecord в свойстве Details на TestResult. Например, если ваши результаты испытаний сохранены в переменном results, найдите записанную диагностику для второго теста в комплекте путем вызова records = result(2).Details.DiagnosticRecord.

Записанная диагностика является объектами DiagnosticRecord. Чтобы получить доступ к конкретным типам диагностического теста для конкретного теста, используйте selectFailed, selectPassed, selectIncomplete и методы selectLogged класса DiagnosticRecord.

По умолчанию плагин DiagnosticsRecordingPlugin записывает отказы проверки и регистрируемые события на уровне matlab.unittest.Verbosity.Terse многословия. Для получения дополнительной информации смотрите DiagnosticsRecordingPlugin и DiagnosticRecord.

Индивидуальная настройка исполнителя тестов

Используйте объект TestRunner настроить способ, которым среда запускает тестовый набор. С объектом TestRunner вы можете:

Например, используйте тестовый набор, suite, чтобы создать тихого исполнителя тестов и запустить тесты с методом run TestRunner.

runner = matlab.unittest.TestRunner.withNoPlugins;
results = runner.run(suite);

Используйте плагины, чтобы настроить исполнителя тестов далее. Например, можно перенаправить вывод, определить покрытие кода или измениться, как исполнитель тестов отвечает на предупреждения. Для получения дополнительной информации смотрите, Добавляет Плагин к Исполнителю тестов и классам plugins.