matlab.unittest.TestSuite.fromProject

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

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

Синтаксис

suite = matlab.unittest.TestSuite.fromProject(project)
suite = matlab.unittest.TestSuite.fromProject(project,selector)
suite = matlab.unittest.TestSuite.fromProject(project,Name,Value)

Описание

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

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

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

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

расширить все

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

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

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

Фильтр для TestSuite элементы массива, заданные как образец класса селектора из matlab.unittest.selectors Package.

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

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

Задайте необязательные разделенные разделенными запятой парами 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);

Типы данных: logical

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

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

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

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

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

The 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 массив

Признаки

Statictrue

Чтобы узнать об атрибутах методов, см. «Атрибуты метода».

Примеры

расширить все

Создайте тестовый набор из файлов проекта, которые помечены как Тестовые файлы. Этот пример принимает, что папка проекта в 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)

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

import matlab.unittest.TestSuite
project = openProject('C:/projects/project1/');
suite = TestSuite.fromProject(project,'IncludingReferencedProjects',true);
result = run(suite)
Введенный в R2019a
Для просмотра документации необходимо авторизоваться на сайте