matlab.unittest.TestSuite.fromProject

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

Создайте массив тестового набора из тестов в проекте

Описание

пример

suite = matlab.unittest.TestSuite.fromProject(project) создает TestSuite массив от всех тестовых файлов содержал в заданном проекте, которые помечены Test классификация. project входом является любой загруженный matlab.project.Project возразите или корневая папка проекта. Этот метод не является рекурсивным. Это включает только те тесты в заданный проект. Чтобы включать тесты от ссылок на проекты, установите 'IncludingReferencedProjects' к true. Для получения дополнительной информации о проектах см. Проекты.

suite = matlab.unittest.TestSuite.fromProject(project,selector) создает TestSuite массив от всех тестовых файлов содержал в заданном проекте, которые помечены Test классификация и которые удовлетворяют selector. Для получения дополнительной информации о селекторах смотрите matlab.unittest.selectors.

пример

suite = matlab.unittest.TestSuite.fromProject(___,Name,Value) создает TestSuite массив от всех тестовых файлов содержал в заданном проекте, которые помечены Test классификация и которые удовлетворяют условиям, заданным одними или несколькими аргументами name-value. Задайте аргументы name-value после всех аргументов в любом из предыдущих синтаксисов.

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

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

Проект, содержащий тестовые файлы в виде пути к корневой папке проекта или открытому Project объект. Тестовый файл является файлом, который классифицируется как тест путем добавления Test пометьте в проекте.

Пример: 'C:\MyProjects\ThisProject'

Типы данных: char | string

Отфильтруйте для TestSuite элементы массива в виде экземпляра селекторного класса от matlab.unittest.selectors пакет.

Пример: matlab.unittest.selectors.HasBaseFolder(fullfile(pwd,'MyTests','Feature1'))

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

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

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

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

Укажите, включать ли тесты от ссылок на проекты в TestSuiteВ виде логического true или false. По умолчанию, fromProject включает тестовые файлы только из проекта, заданного во входе. Передача значения true для IncludingReferencedProjects результаты в TestSuite массив, который включает тесты из проекта, заданного во входе и тестах из проектов, на которые ссылаются из родительского проекта. Для получения дополнительной информации о ссылках на проекты смотрите, Разбивают на компоненты Крупные проекты.

Пример: suite = matlab.unittest.TestSuite.fromProject(project,'IncludingReferencedProjects',true);

Типы данных: логический

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

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

Имя параметра, используемого элементом тестового набора в виде массива строк, вектора символов или массива ячеек из символьных векторов. MATLAB® генерирует названия параметра на основе тестового свойства класса, которое задает параметры:

  • Если значение свойства является массивом ячеек из символьных векторов, MATLAB генерирует названия параметра от значений в массиве ячеек. В противном случае MATLAB задает названия параметра как value1, value2, …, valueN.

  • Если значение свойства является структурой, MATLAB генерирует названия параметра от полей структуры.

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

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

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

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

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

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

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

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

Примеры

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

Создайте тестовый набор из файлов проекта, которые помечены как Test файлы. Этот пример принимает что папка проекта в C:/projects/project1 содержит тестовые файлы, которые помечены Test классификация. Используйте matlab.unittest.TestSuite.fromProject статический метод создать тестовый набор с помощью тех тестов.

Открытый project1 и передайте matlab.project.Project возразите против fromProject. Запустите тестовый набор и получите результаты.

import matlab.unittest.TestSuite
project = openProject('C:/projects/project1/');
suite = TestSuite.fromProject(project);
result = run(suite)

Создайте тестовый набор из файлов проекта, которые помечены как Test файлы в проекте и всех ссылках на проекты.

import matlab.unittest.TestSuite
project = openProject('C:/projects/project1/');
suite = TestSuite.fromProject(project,'IncludingReferencedProjects',true);
result = run(suite)

Вопросы совместимости

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

Поведение изменяется в R2021b

Введенный в R2019a