Exponenta Banner

matlab.unittest.plugins. TAPPlugin.producingVersion13

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

Создайте TAPPlugin для формата TAP версии 13

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

Синтаксис

matlab.unittest.plugins. TAPPlugin.producingVersion13
(Поток) matlab.unittest.plugins. TAPPlugin.producingVersion13
matlab.unittest.plugins. TAPPlugin.producingVersion13 (___, Имя, Значение)

Описание

пример

matlab.unittest.plugins. TAPPlugin.producingVersion13 создает плагин, который производит вывод в версии 13 формата Test Anything Protocol (TAP). Версия 13 TAP вывод включает диагностический тест в блоки YAML. По умолчанию плагин использует поток ToStandardOutput, и вывод появляется на экране. В этом случае другой вывод, отправленный в экран, может делать недействительным поток TAP.

(Поток) matlab.unittest.plugins. TAPPlugin.producingVersion13 перенаправляет весь текст вывод к заданному потоку вывода. Например, можно перенаправить вывод к потоку ToFile.

matlab.unittest.plugins. TAPPlugin.producingVersion13 (___, Имя, Значение) создает плагин с дополнительными опциями, заданными одним или несколькими Имя, аргументы пары Значения.

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

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

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

Пример: поток = matlab.unittest. плагины. ToStandardOutput

Пример: поток = matlab.unittest. плагины. ToFile ('myFile.tap')

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

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

Пример: TAPPlugin.producingVersion13 ('LoggingLevel', Многословие. Подробный), создает плагин, который включает диагностику, регистрируемую в и ниже Подробного уровня.

Включать ли передающую диагностику события, заданную как false или true. По умолчанию плагин не включает диагностику от передающих событий.

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

Максимальный уровень, в который регистрируемая диагностика включена сменным экземпляром, задал как целочисленное значение от 0 до 4, или как объект перечисления matlab.unittest.Verbosity. Плагин включает диагностику, которая регистрируется на этом уровне и ниже. Целочисленные значения соответствуют членам matlab.unittest.Verbosity Перечисление многословия.

Числовое представлениеИмя элемента перечисленияОписание многословия
0'none'

Никакая информация

1Terse

Минимальная информация

2Concise

Умеренный объем информации

3Detailed

Некоторая дополнительная информация

4Verbose

Большая дополнительная информация

По умолчанию плагин включает диагностику, регистрируемую в уровень matlab.unittest.Verbosity.Terse (уровень 1). Чтобы исключить регистрируемую диагностику, задайте LoggingLevel как Verbosity.None (уровень 0).

Регистрируемая диагностика является диагностикой, которую вы предоставляете к среде тестирования вызов метода Fixture.log или TestCase.log.

Уровень детализации для событий, о которых сообщают, заданных как целочисленное значение от 0 до 4, или как объект перечисления matlab.unittest.Verbosity. Целочисленные значения соответствуют членам matlab.unittest.Verbosity Перечисление многословия.

Сменная передача отчетов, сбой и регистрируемые события с суммой детали заданы OutputDetail. По умолчанию плагин записывает события на уровне matlab.unittest.Verbosity.Detailed (уровень 3).

Числовое представлениеИмя элемента перечисленияОписание многословия
0'none'

Никакая информация

1Terse

Минимальная информация

2Concise

Умеренный объем информации

3Detailed

Некоторая дополнительная информация

4Verbose

Большая дополнительная информация

Примеры

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

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

classdef ExampleTest < matlab.unittest.TestCase
    methods(Test)
        function testOne(testCase)  % Test fails
            testCase.verifyEqual(5,4,'Testing 5==4')
        end
        function testTwo(testCase)  % Test passes
            testCase.verifyEqual(5,5,'Testing 5==5')
        end
        function testThree(testCase)
            % test code
        end
    end
end

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

import matlab.unittest.TestRunner
import matlab.unittest.TestSuite
import matlab.unittest.plugins.TAPPlugin
import matlab.unittest.plugins.ToFile

suite = TestSuite.fromClass(?ExampleTest);

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

runner = TestRunner.withTextOutput;

Создайте TAPPlugin, который отправляет вывод в файл MyTapOutput.tap.

tapFile = 'MyTAPOutput.tap';
plugin = TAPPlugin.producingVersion13(ToFile(tapFile));

Добавьте плагин к TestRunner и запустите комплект.

runner.addPlugin(plugin)
result = runner.run(suite);
Running ExampleTest

================================================================================
Verification failed in ExampleTest/testOne.

    ----------------
    Test Diagnostic:
    ----------------
    Testing 5==4

    ---------------------
    Framework Diagnostic:
    ---------------------
    verifyEqual failed.
    --> The values are not equal using "isequaln".
    --> Failure table:
                Actual    Expected    Error    RelativeError
                ______    ________    _____    _____________
            
                5         4           1        0.25         
    
    Actual double:
             5
    Expected double:
             4

    ------------------
    Stack Information:
    ------------------
    In C:\work\ExampleTest.m (ExampleTest.testOne) at 4
================================================================================
...
Done ExampleTest
__________

Failure Summary:

     Name                 Failed  Incomplete  Reason(s)
    ==================================================================
     ExampleTest/testOne    X                 Failed by verification.

Отобразите файл, созданный плагином.

disp(fileread(tapFile))
TAP version 13
1..3
not ok 1 - ExampleTest/testOne
    ---
    Event:
        Event Name: 'VerificationFailed'
        Event Location: 'ExampleTest/testOne'
        Test Diagnostic: |
            Testing 5==4
        Framework Diagnostic: |
            verifyEqual failed.
            --> The values are not equal using "isequaln".
            --> Failure table:
                    Actual    Expected    Error    RelativeError
                    ______    ________    _____    _____________
                
                    5         4           1        0.25         
            
            Actual Value:
                 5
            Expected Value:
                 4
        Stack: |
            In C:\work\ExampleTest.m (ExampleTest.testOne) at 4
    ...
ok 2 - ExampleTest/testTwo
ok 3 - ExampleTest/testThree

Можно использовать TAPPlugin, направленный к стандартному выводу. Однако любой другой текст, отображенный к стандартному выводу (такому как отказавшая информация о тесте), прерывает поток и имеет потенциал, чтобы делать недействительным его.

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

| |

Внешние веб-сайты

Введенный в R2017b

Была ли эта тема полезной?
Документация MATLAB
Поддержка