selectIf

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

Выберите элементы тестового набора, которые удовлетворяют условиям

Синтаксис

newsuite = selectIf(suite,s)

newsuite = selectIf(suite,Name,Value)

Описание

newsuite = selectIf(suite,s) выбирает из suite тестовые элементы, которые удовлетворяют условиям, заданным селектором, s, и возвращает их в TestSuite массив, newsuite.

пример

newsuite = selectIf(suite,Name,Value) создает TestSuite массив с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы.

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

`suite`	Набор тестов в виде `matlab.unittest.TestSuite` массив.
`s`	Селектор в виде экземпляра класса от `matlab.unittest.selector` пакет.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

`BaseFolder`	Имя папки, которая содержит файл, задающий тесты в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `Test` элемент должен содержаться в одной из основных папок, заданных `BaseFolder`. Если ни один из `Test` элементы совпадают с основной папкой, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` совпадать с отдельным символом.
`Name`	Имя элемента набора в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `Name` свойство `Test` элемент должен совпадать с одним из имен, заданных `Name`. Если ни один из `Test` элементы имеют соответствующее имя, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` совпадать с отдельным символом.
`ParameterProperty`	Имя тестового свойства класса, которое задает параметр, используемый элементом тестового набора в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `Parameterization` свойство `Test` элемент должен содержать по крайней мере одно из имен свойства, заданных `ParameterProperty`. Если ни один из `Test` элементы имеют соответствующее имя свойства, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` соответствовать к отдельному символу.
`ParameterName`	Имя параметра, используемого элементом тестового набора в виде массива строк, вектора символов или массива ячеек из символьных векторов. MATLAB^® генерирует названия параметра на основе тестового свойства класса, которое задает параметры: Если значение свойства является массивом ячеек из символьных векторов, MATLAB генерирует названия параметра от значений в массиве ячеек. В противном случае MATLAB задает названия параметра как `value1`, `value2`, …, `valueN`. Если значение свойства является структурой, MATLAB генерирует названия параметра от полей структуры. `ParameterName` аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `Parameterization` свойство `Test` элемент должен содержать по крайней мере одно из названий параметра, заданных `ParameterName`. Если ни один из `Test` элементы имеют соответствующее название параметра, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` совпадать с отдельным символом.
`ProcedureName`	Имя процедуры тестирования в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `ProcedureName` свойство `Test` элемент должен совпадать с одними из имен процедур, заданных `ProcedureName`. Если ни один из `Test` элементы имеют соответствующее имя процедуры, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` совпадать с отдельным символом. В основанном на классах тесте, `ProcedureName` имя метода тестирования. В функциональном тесте это - имя локальной функции, которая содержит тест. В тесте на основе скриптов это - имя, сгенерированное из заголовка экспериментального участка. В отличие от `Name`, имя процедуры тестирования не включает класса или имени пакета или информации о параметризации.
`Superclass`	Имя класса, из которого выводит тестовый класс в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `TestClass` свойство `Test` элемент должен указать на тестовый класс, который выводит из одного из классов, заданных `Superclass`. Если ни один из `Test` элементы совпадают с классом, пустой тестовый набор возвращен.
`Tag`	Имя тестового тега, используемого элементом тестового набора в виде массива строк, вектора символов или массива ячеек из символьных векторов. Этот аргумент фильтрует `TestSuite` элементы массива. Для среды тестирования, чтобы включать тест в набор, `Tags` свойство `Test` элемент должен содержать по крайней мере одно из имен тега, заданных `Tag`. Если ни один из `Test` элементы имеют соответствующее имя тега, пустой тестовый набор возвращен. Используйте подстановочный символ `*` совпадать с любым количеством символов. `Используйте символа вопросительного знака, ?` совпадать с отдельным символом.

Примеры

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

Выбор Test Elements Using Selector

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

classdef (SharedTestFixtures={...
        matlab.unittest.fixtures.PathFixture(fullfile(...
        matlabroot, 'help', 'techdoc', 'matlab_oop', 'examples'))})...
        ExampleTest < matlab.unittest.TestCase
    methods(Test)
        function testPathAdd(testCase)
            % test code
        end
        function testOne(testCase)
            % test code
        end
         function testTwo(testCase)
            % test code
        end
    end
end

В командной строке создайте тестовый набор из ExampleTest класс.

import matlab.unittest.TestSuite;
import matlab.unittest.selectors.HasSharedTestFixture;
import matlab.unittest.selectors.HasName;
import matlab.unittest.fixtures.PathFixture;
import matlab.unittest.constraints.EndsWithSubstring;
import matlab.unittest.constraints.ContainsSubstring;

suite = TestSuite.fromClass(?ExampleTest)

suite = 

  1×3 Test array with properties:

    Name
    ProcedureName
    TestClass
    BaseFolder
    Parameterization
    SharedTestFixtures
    Tags

Tests Include:
   0 Parameterizations, 1 Unique Shared Test Fixture Class, 0 Tags.

Тестовый набор содержит три тестовых элемента.

Создайте набор отфильтрованного теста тестов, включающих тесты с именами, которые содержат нечувствительный к регистру текст 'pAtH'.

newSuite = selectIf(suite,HasName(ContainsSubstring('pAtH','IgnoringCase',true)))

newSuite = 

  Test with properties:

                  Name: 'ExampleTest/testPathAdd'
         ProcedureName: 'testPathAdd'
             TestClass: "ExampleTest"
            BaseFolder: 'C:\work'
      Parameterization: [0×0 matlab.unittest.parameters.EmptyParameter]
    SharedTestFixtures: [1×1 matlab.unittest.fixtures.PathFixture]
                  Tags: {1×0 cell}

Tests Include:
   0 Parameterizations, 1 Unique Shared Test Fixture Class, 0 Tags.

Только testPathAdd тест является частью набора.

В качестве альтернативы создайте тот же набор с помощью пары "имя-значение".

newSuite = selectIf(suite,'Name','*Path*');

Однако различающийся ContainsSubstring ограничение, пара "имя-значение" не имеет опции, чтобы игнорировать регистр.

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

newSuite = suite.selectIf(~HasName(EndsWithSubstring('One')) ...
    & HasSharedTestFixture(PathFixture(fullfile(matlabroot, 'help',...
    'techdoc', 'matlab_oop', 'examples'))));
{newSuite.Name}

ans = 

    'ExampleTest/testPathAdd'    'ExampleTest/testTwo'

Тестовый набор содержит два теста. Все тесты используют заданный фиксатор пути, но тест под названием 'testOne' исключен из набора.

Выбор Test Elements Using Parameterization

В вашей рабочей папке создайте 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.

В командной строке создайте тестовый набор из файла.

s = matlab.unittest.TestSuite.fromFile('testZeros.m');
{s.Name}'

ans =

  11×1 cell array

    {'testZeros/testClass(type=single,outSize=s2d)'}
    {'testZeros/testClass(type=single,outSize=s3d)'}
    {'testZeros/testClass(type=double,outSize=s2d)'}
    {'testZeros/testClass(type=double,outSize=s3d)'}
    {'testZeros/testClass(type=uint16,outSize=s2d)'}
    {'testZeros/testClass(type=uint16,outSize=s3d)'}
    {'testZeros/testSize(outSize=s2d)'             }
    {'testZeros/testSize(outSize=s3d)'             }
    {'testZeros/testDefaultClass'                  }
    {'testZeros/testDefaultSize'                   }
    {'testZeros/testDefaultValue'                  }

Набор содержит 11 тестовых элементов. Шесть от параметрированного testClass метод, два от параметрированного testSize метод, и один от каждого testDefaultClass, testDefaultSize, и testDefaultValue методы.

Выберите все тестовые элементы от параметрированных методов тестирования.

import matlab.unittest.selectors.HasParameter;

s1 = s.selectIf(HasParameter);
{s1.Name}'

ans =

  8×1 cell array

    {'testZeros/testClass(type=single,outSize=s2d)'}
    {'testZeros/testClass(type=single,outSize=s3d)'}
    {'testZeros/testClass(type=double,outSize=s2d)'}
    {'testZeros/testClass(type=double,outSize=s3d)'}
    {'testZeros/testClass(type=uint16,outSize=s2d)'}
    {'testZeros/testClass(type=uint16,outSize=s3d)'}
    {'testZeros/testSize(outSize=s2d)'             }
    {'testZeros/testSize(outSize=s3d)'             }

Набор содержит восемь тестовых элементов от двух параметрированных методов тестирования.

Выберите все тестовые элементы от непараметрированных методов тестирования.

s2 = s.selectIf(~HasParameter);
{s2.Name}'

ans =

  3×1 cell array

    {'testZeros/testDefaultClass'}
    {'testZeros/testDefaultSize' }
    {'testZeros/testDefaultValue'}

Выберите все тестовые элементы, которые параметрируются и имеют свойство под названием 'type' с названием параметра 'double'.

s3 = s.selectIf('ParameterProperty','type', 'ParameterName','double');
{s3.Name}'

ans =

  2×1 cell array

    {'testZeros/testClass(type=double,outSize=s2d)'}
    {'testZeros/testClass(type=double,outSize=s3d)'}

Получившийся набор содержит два элемента. testClass метод является единственным методом в testZeros это использует 'type' свойство и выбор только 'double' от параметров приводит к двум тестовым элементам — один для каждого значения 'outSize'.

Выберите все тестовые элементы, которые параметрируются и задали параметр свойством начиная с 't'.

s4 = s.selectIf('ParameterProperty','t*');
{s4.Name}'

ans =

  6×1 cell array

    {'testZeros/testClass(type=single,outSize=s2d)'}
    {'testZeros/testClass(type=single,outSize=s3d)'}
    {'testZeros/testClass(type=double,outSize=s2d)'}
    {'testZeros/testClass(type=double,outSize=s3d)'}
    {'testZeros/testClass(type=uint16,outSize=s2d)'}
    {'testZeros/testClass(type=uint16,outSize=s3d)'}

Получившийся набор содержит шесть параметрированных тестовых элементов от testClass метод. testSize метод параметрируется, но элементы из метода не включены в набор, потому что метод не использует свойство, которое запускается с 't'.

Выберите все тестовые элементы, которые параметрируются и тестируют zeros функция с 2-D массив. Значение параметров, представляющее 2-D массив будет иметь длину 1 (например, zeros(3)) или 2 (например, zeros(2,3)).

import matlab.unittest.constraints.HasLength;

s5 = s.selectIf(HasParameter('Property','outSize',...
    'Value', HasLength(1)|HasLength(2)));
{s5.Name}'

ans =

  4×1 cell array

    {'testZeros/testClass(type=single,outSize=s2d)'}
    {'testZeros/testClass(type=double,outSize=s2d)'}
    {'testZeros/testClass(type=uint16,outSize=s2d)'}
    {'testZeros/testSize(outSize=s2d)'             }

Выберите только тестовый элемент, который тестирует это, выходом является double тип данных и имеет правильный размер для 2-D массив.

s6 = s.selectIf(HasParameter('Property','type','Name','double')...
    & HasParameter('Property','outSize','Name','s2d'))

s6 = 

  Test with properties:

                  Name: 'testZeros/testClass(type=double,outSize=s2d)'
         ProcedureName: 'testClass'
             TestClass: "testZeros"
            BaseFolder: 'C:\work'
      Parameterization: [1×2 matlab.unittest.parameters.TestParameter]
    SharedTestFixtures: [0×0 matlab.unittest.fixtures.EmptyFixture]
                  Tags: {1×0 cell}

Tests Include:
   2 Unique Parameterizations, 0 Shared Test Fixture Classes, 0 Tags.

Выбор Test Elements Using Tags

Создайте следующий тестовый класс в файле, ExampleTest.m, в вашей текущей папке.

classdef ExampleTest < matlab.unittest.TestCase
    methods (Test)
        function testA (testCase)
            % test code
        end
    end
    methods (Test, TestTags = {'Unit'})
        function testB (testCase)
            % test code
        end
        function testC (testCase)
            % test code
        end
    end
    methods (Test, TestTags = {'Unit','FeatureA'})
        function testD (testCase)
            % test code
        end
    end
    methods (Test, TestTags = {'System','FeatureA'})
        function testE (testCase)
            % test code
        end
    end
end

В командной строке создайте тестовый набор из ExampleTest класс и исследует содержимое.

import matlab.unittest.TestSuite
import matlab.unittest.selectors.HasTag

suite = TestSuite.fromClass(?ExampleTest)

suite = 

  1×5 Test array with properties:

    Name
    ProcedureName
    TestClass
    BaseFolder
    Parameterization
    SharedTestFixtures
    Tags

Tests Include:
   0 Parameterizations, 0 Shared Test Fixture Classes, 3 Unique Tags.

Кликните по гиперссылке для 3 Unique Tags отобразить все теги в наборе.

        Tag     
    ____________

    {'FeatureA'}
    {'System'  }
    {'Unit'    }

Выберите все элементы тестового набора, которые имеют тег 'Unit'.

s1 = suite.selectIf(HasTag('Unit'))

s1 = 

  1×3 Test array with properties:

    Name
    ProcedureName
    TestClass
    BaseFolder
    Parameterization
    SharedTestFixtures
    Tags

Tests Include:
   0 Parameterizations, 0 Shared Test Fixture Classes, 2 Unique Tags.

Выберите все элементы тестового набора, которые не содержат тег 'FeatureA'.

s2 =  suite.selectIf(~HasTag('FeatureA'));
{s2.Name}

ans =

  1×3 cell array

    {'ExampleTest/testB'}    {'ExampleTest/testC'}    {'ExampleTest/testA'}

Выберите все элементы тестового набора, которые не имеют никаких тегов.

s3 =  suite.selectIf(~HasTag)

s3 = 

  Test with properties:

                  Name: 'ExampleTest/testA'
         ProcedureName: 'testA'
             TestClass: "ExampleTest"
            BaseFolder: 'C:\work'
      Parameterization: [0×0 matlab.unittest.parameters.EmptyParameter]
    SharedTestFixtures: [0×0 matlab.unittest.fixtures.EmptyFixture]
                  Tags: {1×0 cell}

Tests Include:
   0 Parameterizations, 0 Shared Test Fixture Classes, 0 Tags.

Введенный в R2014a

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