Exponenta Banner
exponenta event banner

matlab.unittest. TestSuite.fromProject

Класс: matlab.unittest.StartSuite
Пакет: 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 классификация. 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 элементы имеют соответствующее имя свойства, возвращается пустой набор тестов. Использовать подстановочный символ * для соответствия любому количеству символов. Использовать знак вопроса ? соответствует одному символу.

Имя параметра, используемого элементом набора тестов, заданного как строковый массив, символьный вектор или массив ячеек символьных векторов. 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 множество

Признаки

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

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

Поддержка