matlab.unittest.

Класс: matlab.unittest.
Пакет: matlab.unittest

Создайте массив TestSuite из одного метода тестирования

Синтаксис

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod)
suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,s)
suite = matlab.unittest.TestSuite.fromMethod(___,Name,Value)

Описание

пример

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod) создает массив TestSuite из тестового класса, описанного testClass и методом тестирования, описанным testMethod, и возвращает его в suite.

пример

suite = matlab.unittest.TestSuite.fromMethod(testClass,testMethod,s) создает массив TestSuite изо всех методов Test, содержавшихся в testMethod, которые удовлетворяют условия, заданные селектором, s.

пример

suite = matlab.unittest.TestSuite.fromMethod(___,Name,Value) создает массив TestSuite с дополнительными опциями, заданными одним или несколькими аргументами пары Name,Value. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.

Входные параметры

testClass

Класс, описывающий методы тестирования, заданные как экземпляр meta.class, который должен вывести от matlab.unittest.TestCase.

testMethod

Метод тестирования, заданный или экземпляром meta.method или именем как вектор символов или скаляр строки. Метод должен быть задан с атрибутом метода Test.

s

Селектор, заданный как экземпляр класса от пакета matlab.unittest.selector.

Аргументы в виде пар имя-значение

'BaseFolder'

Вектор символов или скаляр строки указание на имя родительского элемента папки пакета верхнего уровня, которая содержит файл, задающий тестовый класс или функцию. Этот аргумент фильтрует элементы массива TestSuite. Для тестового элемента, который будет включен в комплект, тестовый элемент должен содержаться в заданной основной папке. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы соответствовать точно к одному символу.

'ExternalParameters'

Массив экземпляров matlab.unittest.parameters.Parameter для использования в параметризованных тестах. Среда использует эти внешние параметры вместо соответствующих параметров, которые заданы в параметризованном тесте. Для получения дополнительной информации смотрите Использование Внешние Параметры в Параметризованном Тесте.

'Name'

Вектор символов или скаляр строки указание на имя элемента комплекта. Этот аргумент фильтрует элементы массива TestSuite. Чтобы включать тестовый элемент в комплект, свойство Name тестового элемента должно совпадать с указанным именем. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы соответствовать точно к одному символу.

'ParameterName'

Вектор символов или скаляр строки указание на имя параметра используются элементом тестового набора. Этот аргумент фильтрует элементы массива TestSuite. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы соответствовать точно к одному символу.

'ParameterProperty'

Вектор символов или скаляр строки указание на имя свойства, которое задает параметр, используемый элементом тестового набора. Этот аргумент фильтрует элементы массива TestSuite. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы соответствовать точно к одному символу.

'ProcedureName'

Имя процедуры тестирования, заданной как вектор символов или скаляр строки. Этот аргумент фильтрует элементы массива TestSuite. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы соответствовать точно к одному символу.

В основанном на классах тесте ProcedureName является именем метода тестирования. В функциональном тест это - имя локальной функции, которая содержит тест. В тесте на основе скриптов это - имя, сгенерированное из заголовка экспериментального участка. В отличие от Name, имя процедуры тестирования не включает класса или имени пакета или информации о параметризации.

'Superclass'

Имя класса, который тестовый класс выводит от, заданный как скаляр строки или вектор символов. Этот аргумент фильтрует элементы массива TestSuite.

'Tag'

Вектор символов или скаляр строки указание на имя тега применились к элементу тестового набора. Этот аргумент фильтрует элементы массива TestSuite. Этот аргумент фильтрует элементы массива TestSuite. Используйте символ подстановки *, чтобы соответствовать любому количеству символов. Используйте символ вопросительного знака, ?, чтобы совпадать точно с одним символом.

Выходные аргументы

suite

Набор тестов, заданных как массив matlab.unittest.Test.

Примеры

развернуть все

Добавьте класс matlab.unittest.TestSuite в текущий список импорта.

import matlab.unittest.TestSuite;
cls = ?mypackage.MyTestClass;
    
% Create the suite using the method name
suite = TestSuite.fromMethod(cls, 'testMethod');
result = run(suite)
 
% Create the suite using the meta.method instance
metaMethod = findobj(cls.MethodList, 'Name', 'testMethod');
suite = TestSuite.fromMethod(cls, metaMethod);
result = run(suite)

В вашей рабочей папке создайте следующий тестовый файл testZeros.m. Этот класс содержит четыре метода тестирования.

classdef testZeros < matlab.unittest.TestCase
    properties (TestParameter)
        type = {'single','double','uint16'};
        outSize = struct('s2d',[3 3], 's3d',[2 5 4]);
    end
    
    methods (Test)
        function testClass(testCase, type, outSize)
            testCase.verifyClass(zeros(outSize,type), type);
        end
        
        function testSize(testCase, outSize)
            testCase.verifySize(zeros(outSize), outSize);
        end
        
        function testDefaultClass(testCase)
            testCase.verifyClass(zeros, 'double');
        end
        function testDefaultSize(testCase)
            testCase.verifySize(zeros, [1 1]);
        end
        
        function testDefaultValue(testCase)
            testCase.verifyEqual(zeros,0);
        end
    end
end

Тестовый класс содержит два параметризованных метода тестирования, testClass и testSize.

В командной строке создайте тестовый набор из всех параметризованных тестов из метода testClass, которые используют название параметра 'single'.

import matlab.unittest.TestSuite;
import matlab.unittest.selectors.HasParameter;

suite = TestSuite.fromMethod(?testZeros,'testClass', ...
    HasParameter('Name','single'));
{suite.Name}'
ans = 

    'testZeros/testClass(type=single,outSize=s2d)'
    'testZeros/testClass(type=single,outSize=s3d)'

Создайте класс testZeros.m из предыдущего примера.

В командной строке создайте тестовый набор из всех параметризованных тестов из метода testClass, которые используют название параметра 'single'.

import matlab.unittest.TestSuite;

suite = TestSuite.fromMethod(?testZeros,'testClass', ...
    'ParameterName','single');
{suite.Name}'
ans = 

    'testZeros/testClass(type=single,outSize=s2d)'
    'testZeros/testClass(type=single,outSize=s3d)'

Советы

  • testClass должен быть на пути MATLAB® при использовании этого метода, чтобы создать suite, а также когда suite запущен.

Введенный в R2013a

Для просмотра документации необходимо авторизоваться на сайте