Exponenta Banner
exponenta event banner

selectIncomplete

Класс: matlab.unittest.plugins.diagnosticrecord.DiagnosticRecord
Пакет: matlab.unittest.plugins.dagnosticrecord

Возврат диагностических записей для незавершенных событий

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

Синтаксис

selectedRecords = selectIncomplete(records)

Описание

selectedRecords = selectIncomplete(records) возвращает диагностические записи для неполных событий в виде массива matlab.unittest.plugins.diagnosticrecord.QualificationDiagnosticRecord и matlab.unittest.plugins.diagnosticrecord.ExceptionDiagnosticRecord экземпляры.

Неполные события - это события, которые приводят к неполному тестированию TestResult. Эти события включают в себя ошибки допущений, ошибки утверждения и неподнаружение MException объекты.

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

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

Записанная диагностика по результату теста, заданному как массив matlab.unittest.plugins.diagnosticrecord.DiagnosticRecord экземпляры. Доступ к записанной диагностике через DiagnosticRecord в поле Details свойство на TestResult. Например, если результаты теста хранятся в переменной results, найдите записанную диагностику для второго теста путем вызова records = result(2).Details.DiagnosticRecord.

Примеры

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

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

classdef ExampleTest < matlab.unittest.TestCase  
    methods (Test)
        function testA(testCase)
            testCase.log(1,'Terse log message') 	% logs
            testCase.log(3,'Detailed log message') 	% logs
            testCase.verifyEqual(3+2,5)             % passes
            testCase.assumeTrue(true)               % passes
            testCase.verifyGreaterThan(5, 9)        % fails
            testCase.assertEqual(3.14,pi)           % fails/incomplete
        end
        function testB(testCase)
            % This test contains an intentional error - passing a character
            % instead of a variable to the ones function.
            a = [1 2];
            testCase.verifyEqual(ones('a'),[1 1]);  % errors
        end
    end
end

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

suite   = testsuite('ExampleTest');

Создайте тестовый питатель без подключаемых модулей. Этот код создает бесшумный питатель и обеспечивает полный контроль над установленными подключаемыми модулями. Добавить DiagnosticsRecordingPlugin на испытательный питатель.

import matlab.unittest.TestRunner;
import matlab.unittest.plugins.DiagnosticsRecordingPlugin;

runner = TestRunner.withNoPlugins;
runner.addPlugin(DiagnosticsRecordingPlugin);

Запустите тесты.

results = runner.run(suite);

Просмотрите результат второго теста. Тест завершается неуспешно и является неполным.

results(2)
ans = 

  TestResult with properties:

          Name: 'ExampleTest/testB'
        Passed: 0
        Failed: 1
    Incomplete: 1
      Duration: 7.8912e-04
       Details: [1×1 struct]

Totals:
   0 Passed, 1 Failed, 1 Incomplete.
   0.00078912 seconds testing time.

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

results(2).Details.DiagnosticRecord
ans = 

  ExceptionDiagnosticRecord with properties:

                          Event: 'ExceptionThrown'
                     EventScope: TestMethod
                  EventLocation: 'ExampleTest/testB'
                      Exception: [1×1 MException]
    AdditionalDiagnosticResults: [1×0 matlab.unittest.diagnostics.DiagnosticResult]
                          Stack: [1×1 struct]
                         Report: 'Error occurred in ExampleTest/testB and it did not run to completion…'

Тест бросает непроверенное исключение.

Сбор диагностических записей для первого теста, testA.

testA_records = results(1).Details.DiagnosticRecord
testA_records = 

  1×3 heterogeneous DiagnosticRecord (LoggedDiagnosticRecord, QualificationDiagnosticRecord) array with properties:

    Event
    EventScope
    EventLocation
    Stack
    Report

Просмотр событий, записанных плагином для testA.

{testA_records.Event}'
ans =

  3×1 cell array

    {'DiagnosticLogged'  }
    {'VerificationFailed'}
    {'AssertionFailed'   }

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

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

runner = TestRunner.withNoPlugins;
runner.addPlugin(DiagnosticsRecordingPlugin(...
    'IncludingPassingDiagnostics',true,'OutputDetail',4,'LoggingLevel',4));
results = runner.run(suite);
testA_records = results(1).Details.DiagnosticRecord;

Просмотр событий, записанных плагином для testA.

{testA_records.Event}'
ans =

  6×1 cell array

    {'DiagnosticLogged'  }
    {'DiagnosticLogged'  }
    {'VerificationPassed'}
    {'AssumptionPassed'  }
    {'VerificationFailed'}
    {'AssertionFailed'   }

Плагин записывает диагностическую информацию для всех квалификаций и вызовов log способ.

Выберите все записи с диагностикой неудачных событий.

failedRecords = selectFailed(testA_records)
failedRecords = 

  1×2 QualificationDiagnosticRecord array with properties:

    Event
    EventScope
    EventLocation
    TestDiagnosticResults
    FrameworkDiagnosticResults
    AdditionalDiagnosticResults
    Stack
    Report

Выберите все записи с пройденной диагностикой событий и просмотрите отчет для первой записи.

passedRecords = selectPassed(testA_records);
passedRecords(1).Report
ans =

    'Verification passed in ExampleTest/testA.
     
         ---------------------
         Framework Diagnostic:
         ---------------------
         verifyEqual passed.
         --> The values are equal using "isequaln".
         
         Actual Value:
              5
         Expected Value:
              5
     
         ------------------
         Stack Information:
         ------------------
         In C:\work\ExampleTest.m (ExampleTest.testA) at 6'

Выберите все записи для незавершенных событий.

incompleteRecords = selectIncomplete(testA_records)
incompleteRecords = 

  QualificationDiagnosticRecord with properties:

                          Event: 'AssertionFailed'
                     EventScope: TestMethod
                  EventLocation: 'ExampleTest/testA'
          TestDiagnosticResults: [1×0 matlab.unittest.diagnostics.DiagnosticResult]
     FrameworkDiagnosticResults: [1×1 matlab.unittest.diagnostics.DiagnosticResult]
    AdditionalDiagnosticResults: [1×0 matlab.unittest.diagnostics.DiagnosticResult]
                          Stack: [1×1 struct]
                         Report: 'Assertion failed in ExampleTest/testA and it did not run to completion…'

Поскольку это событие является ошибкой утверждения, инфраструктура также возвращает эту запись с неисправной диагностикой как failedRecords(2).

Выберите все записи с зарегистрированными событиями и просмотрите зарегистрированные сообщения.

loggedRecords = selectLogged(testA_records);
{loggedRecords.Report}'
ans =

  2×1 cell array

    {'[Terse] Diagnostic logged (2018-04-12 13:15:23): Terse log message'      }
    {'[Detailed] Diagnostic logged (2018-04-12 13:15:23): Detailed log message'}

См. также

| | | | | |

Темы

Представлен в R2016a

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

Поддержка