matlab.unittest.qualifications.Assumable class

Пакет: matlab.unittest.qualifications

Проверка, чтобы отфильтровать содержание теста

Описание

Assumable класс обеспечивает проверку, чтобы отфильтровать содержание теста. Кроме действий, выполняемых для отказов, Assumable класс работает то же самое другими классами проверки в matlab.unittest.qualifications пакет.

После отказа предположения, Assumable класс сообщает среде тестирования об отказе путем броска AssumptionFailedException объект. Среда затем отмечает текущее содержание теста, как отфильтровано и продолжает тестировать. Предположения гарантируют, что тест запущен только, когда определенным предусловиям соответствуют, но запущение теста, не удовлетворяя предусловиям не производит непройденный тест. Если предусловия, которым не соответствуют, предназначаются, чтобы произвести непройденный тест, используйте утверждения вместо предположений.

Когда отказ предположения производится в рамках метода TestCase класс, тип метода определяет, какие тесты отфильтрованы:

Test метод — маркеры инфраструктуры целый Test метод, как отфильтровано.
TestMethodSetup или TestMethodTeardown метод — маркеры инфраструктуры Test метод, чтобы запуститься для того экземпляра метода, как отфильтровано.
TestClassSetup или TestClassTeardown метод — маркеры инфраструктуры целый тестовый класс, как отфильтровано.

Когда вы используете предположения, гарантируете, что ваше содержание теста является безопасным исключением. Поскольку предположения не производят непройденные тесты, фрагменты вашего тестового кода могут тихо быть отфильтрованы. Чтобы избежать создания мертвого тестового кода, рассмотрите контроль ваших отфильтрованных тестов.

matlab.unittest.qualifications.Assumable классом является handle класс.

Методы

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

Открытые методы

Assumable класс предоставляет несколько методов проверки для тестирования значений и ответа на отказы. Например, assumeEmpty тесты, что значение пусто, и assumeTrue тесты, что фактическое значение верно.

Примечание

Методы Assumable класс соответствует методам Verifiable класс. Они отличаются только в терминах типа проверки. Можно вызвать Assumable методы таким же образом вы вызываете Verifiable методы.

Общая цель

`assumeEqual`	`assumeEqual(testCase,actual,expected,diagnostic,Name,Value)` Примите тот `actual` строго равно `expected`. Подобно `verifyEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expected` — Ожидаемое значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику. Аргументы name-value `AbsTol` — Абсолютная погрешность в виде числового массива. `RelTol` — Относительная погрешность в виде числового массива.
`assumeFail`	`assumeFail(testCase,diagnostic)` Произведите безусловный отказ предположения. Подобно `verifyFail`. Входные параметры `testCase` Экземпляр TestCase. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeFalse`	`assumeFalse(testCase,actual,diagnostic)` Примите что значение `actual` логический `0` `ложь`). Подобно `verifyFalse`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeNotEqual`	`assumeNotEqual(testCase,actual,prohibited,diagnostic)` Примите тот `actual` не равно `prohibited`. Подобно `verifyNotEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `prohibited` — Значение, чтобы выдержать сравнение с. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeNotSameHandle`	`assumeNotSameHandle(testCase,actual,prohibited,diagnostic)` Примите тот `actual` различный как запрещенный массив указателя. Подобно `verifyNotSameHandle`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `prohibited` — Значение, чтобы выдержать сравнение с в виде массива указателя. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeReturnsTrue`	`assumeReturnsTrue(testCase,actual,diagnostic)` Примите тот `actual` указатель на функцию, который возвращает логический скалярный `1` `TRUE`). Подобно `verifyReturnsTrue`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeSameHandle`	`assumeSameHandle(testCase,actual,expected,diagnostic)` Примите тот `actual` совпадает с ожидаемым массивом указателя. Подобно `verifySameHandle`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expected` — Ожидаемое значение в виде массива указателя. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeThat`	`assumeThat(testCase,actual,constraint,diagnostic)` Примите тот `actual` значение, которое удовлетворяет заданному ограничению. Подобно `verifyThat`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `constraint` — Ограничение, которому фактическое значение должно удовлетворить в виде экземпляра `matlab.unittest.constraints.Constraint` класс. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeTrue`	`assumeTrue(testCase,actual,diagnostic)` Примите что значение `actual` логический `1` `TRUE`). Подобно `verifyTrue`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Ошибки и предупреждения

assumeError

[output1,...,outputN] = assumeError(testCase,actual,identifier,diagnostic)

Примите тот actual указатель на функцию, который выдает исключение, заданное identifier. Подобно verifyError.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
identifier — Ошибочный идентификатор в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

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

output1,...,outputN — Выходные аргументы, 1 через N, который требуют от actual.

assumeWarning

[output1,...,outputN] = assumeWarning(testCase,actual,identifier,diagnostic)

Примите тот actual указатель на функцию, который выдает предупреждение, заданное identifier. Подобно verifyWarning.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
identifier — Предупреждая идентификатор в виде вектора символов, массива ячеек из символьных векторов или массива строк.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

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

output1,...,outputN — Выходные аргументы, 1 через N (если таковые имеются), произведенный, когда actual вызывается.

assumeWarningFree

[output1,...,outputN] = assumeWarningFree(testCase,actual,diagnostic)

Примите тот actual указатель на функцию, который не выдает предупреждений. Подобно verifyWarningFree.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

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

output1,...,outputN — Выходные аргументы, 1 через N (если таковые имеются), произведенный, когда actual вызывается.

Неравенства

`assumeGreaterThan`	`assumeGreaterThan(testCase,actual,floor,diagnostic)` Примите что все элементы `actual` больше всех элементов `floor`. Подобно `verifyGreaterThan`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `floor` — Минимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeGreaterThanOrEqual`	`assumeGreaterThanOrEqual(testCase,actual,floor,diagnostic)` Примите что все элементы `actual` больше или равны всем элементам `floor`. Подобно `verifyGreaterThanOrEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `floor` — Минимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeLessThan`	`assumeLessThan(testCase,actual,ceiling,diagnostic)` Примите что все элементы `actual` меньше всех элементов `ceiling`. Подобно `verifyLessThan`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `ceiling` — Максимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeLessThanOrEqual`	`assumeLessThanOrEqual(testCase,actual,ceiling,diagnostic)` Примите что все элементы `actual` меньше чем или равны всем элементам `ceiling`. Подобно `verifyLessThanOrEqual`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `ceiling` — Максимальное значение. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Размер массивов

`assumeEmpty`	`assumeEmpty(testCase,actual,diagnostic)` Примите тот `actual` пустой MATLAB^® массив. Подобно `verifyEmpty`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeLength`	`assumeLength(testCase,actual,expectedLength,diagnostic)` Примите тот `actual` массив MATLAB с ожидаемой длиной. Подобно `verifyLength`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedLength` — Ожидаемая длина массива. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeNotEmpty`	`assumeNotEmpty(testCase,actual,diagnostic)` Примите тот `actual` непустой массив MATLAB. Подобно `verifyNotEmpty`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeNumElements`	`assumeNumElements(testCase,actual,expectedNumElements,diagnostic)` Примите тот `actual` массив MATLAB с ожидаемым числом элементов. Подобно `verifyNumElements`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedNumElements` — Ожидаемое число элементов. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.
`assumeSize`	`assumeSize(testCase,actual,expectedSize,diagnostic)` Примите тот `actual` массив MATLAB с ожидаемым размером. Подобно `verifySize`. Входные параметры `testCase` Экземпляр TestCase. `actual` — Значение для проверки. `expectedSize` — Ожидаемый размер массивов. `diagnostic` — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Ввод

assumeClass

assumeClass(testCase,actual,class,diagnostic)

Примите что класс actual заданный класс. Подобно verifyClass.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
class — Ожидаемый класс в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

assumeInstanceOf

assumeInstanceOf(testCase,actual,class,diagnostic)

Примите тот actual экземпляр заданного класса. Подобно verifyInstanceOf.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
class — Ожидаемый класс в виде строкового скаляра, вектора символов или meta.class экземпляр.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

Строки

assumeMatches

assumeMatches(testCase,actual,expression,diagnostic)

Примите тот actual строковый скаляр или вектор символов, который совпадает с заданным регулярным выражением. Подобно verifyMatches.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
expression — Регулярное выражение, чтобы соответствовать.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

assumeSubstring

assumeSubstring(testCase,actual,substring,diagnostic)

Примите тот actual строковый скаляр или вектор символов, который содержит substring. Подобно verifySubstring.

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

testCase Экземпляр TestCase.
actual — Значение для проверки.
substring — Текст содержится в фактическом значении.
diagnostic — Диагностическая информация, чтобы отобразиться, когда передачи проверки или сбои. Для получения дополнительной информации смотрите Диагностику.

События

EventName Триггер Данные о событиях Атрибуты события

EventName	Триггер	Данные о событиях	Атрибуты события
`AssumptionFailed`	Инициированный на провальное предположение. `QualificationEventData` объект передается функциям обратного вызова прослушивателя.	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`
`AssumptionPassed`	Инициированный на передающее предположение. `QualificationEventData` объект передается функциям обратного вызова прослушивателя.	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`

AssumptionFailed

Инициированный на провальное предположение. QualificationEventData объект передается функциям обратного вызова прослушивателя.

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

AssumptionPassed

Инициированный на передающее предположение. QualificationEventData объект передается функциям обратного вызова прослушивателя.

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

Примеры

свернуть все

Запустите тесты только на платформе Linux

Скрипт Open Live Script

Используйте предположение, чтобы гарантировать, что ваши тесты могут запуститься только на платформе Linux®. Дайте среде тестирования команду фильтровать тесты, если MATLAB установлен на Microsoft® Windows® или macOS платформе.

В файле в вашей текущей папке создайте LinuxTests класс. Чтобы протестировать на платформу, задайте testPlatform метод в TestClassSetup methods блок. Метод использует вызов assumeTrue метод, чтобы протестировать тот MATLAB установлен на платформе Linux. Если предположение перестало работать, среда фильтрует целый тестовый класс.

classdef LinuxTests < matlab.unittest.TestCase
    methods (TestClassSetup)
        function testPlatform(testCase)
            testCase.assumeTrue(isunix && ~ismac, ...
                "Tests must run on a Linux platform.")
        end
    end
end

Задайте свои тесты в methods блокируйтесь с Test атрибут. Тесты в этом примере в целях рисунка только.

classdef LinuxTests < matlab.unittest.TestCase
    methods (TestClassSetup)
        function testPlatform(testCase)
            testCase.assumeTrue(isunix && ~ismac, ...
                "Tests must run on a Linux platform.")
        end
    end

    methods (Test)
        function test1(testCase)
            testCase.verifyWarningFree(@rand)
        end
        function test2(testCase)
            testCase.verifyWarningFree(@() size([]))
        end
    end
end

Запустите тесты на машине Windows. Поскольку сбои предположения на уровне настройки класса, среда фильтрует тесты, заданные LinuxTests класс.

runtests("LinuxTests")

Running LinuxTests

================================================================================
All tests in LinuxTests were filtered.
    Test Diagnostic: Tests must run on a Linux platform.
Details
================================================================================

Done LinuxTests
__________

Failure Summary:

     Name              Failed  Incomplete  Reason(s)
    ===============================================================
     LinuxTests/test1              X       Filtered by assumption.
    ---------------------------------------------------------------
     LinuxTests/test2              X       Filtered by assumption.

ans = 
  1×2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   0 Passed, 0 Failed, 2 Incomplete.
   0.27782 seconds testing time.

Больше о

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

Диагностика

В зависимости от настройки исполнителя тестов среда тестирования может отобразить диагностику, когда проверка передает или перестала работать. По умолчанию среда отображает диагностику только, когда проверка перестала работать. Можно заменить поведение по умолчанию путем настройки исполнителя тестов. Например, можно использовать DiagnosticsOutputPlugin экземпляр, чтобы отобразить и провальную и передающую диагностику события.

Чтобы добавить диагностическое сообщение в тест, используйте дополнительный diagnostic аргумент в любом из методов проверки. Можно задать diagnostic как массив строк, символьный массив, указатель на функцию или массив matlab.unittest.diagnostics.Diagnostic объекты.

Устойчивость к исключениям

Содержанием теста является exception safe, когда все отключение фиксатора выполняется с addTeardown метод TestCase или Fixture классы, или когда это выполняется с помощью объектных деструкторов после отказа. Безопасность исключения гарантирует, что непройденный тест не влияет на последующие тесты, даже когда исключение выдается.

Например, этот код не является безопасным исключением. Если тест перестал работать, среда тестирования не закрывает фигуру.

% Not exception safe
f = figure;
testCase.assumeEqual(actual,expected)
close(f)

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

% Exception safe
f = figure;
testCase.addTeardown(@close,f)
testCase.assumeEqual(actual,expected)

Разъединение фиксатора с помощью addTeardown не гарантирует, что код является безопасным исключением. Этот код не является безопасным исключением, потому что вызов addTeardown помещается после теста. Если тест перестал работать, среда не может закрыть фигуру.

% Not exception safe
f = figure;
testCase.assumeEqual(actual,expected)
testCase.addTeardown(@close,f)

Темы

Введенный в R2013a

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

matlab.unittest.qualifications.Assumable class

Описание

Методы

Открытые методы

События

Примеры

Запустите тесты только на платформе Linux

Больше о

Диагностика

Устойчивость к исключениям

Смотрите также

Темы

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

Поддержка