matlab.unittest.qualifications.FatalAssertable класс

Пакет: matlab.unittest.qualifications

Квалификация для прекращения выполнения теста

Описание

FatalAssertable класс предоставляет квалификацию для прерывания выполнения теста. Помимо действий, выполняемых при отказах, FatalAssertable класс работает так же, как matlab.unittest квалификация.

После фатального провала утверждения FatalAssertable класс информирует структуру тестирования о сбое, бросив FatalAssertionFailedException. После этого среда выполнения тестов отображает диагностическую информацию об отказе и прерывает весь тестовый сеанс. Это полезно, когда тестируемое программное обеспечение содержит столько ошибок, что не имеет смысла продолжать тестовый сеанс. Кроме того, можно использовать неустранимые утверждения при отрыве приспособления, чтобы гарантировать правильное восстановление состояния приспособления. Если он не восстановлен, сеанс полного тестирования прерывается и указывает на перезапуск MATLAB ® перед возобновлением тестирования. Это позволяет выполнять последующие тесты в согласованном состоянии MATLAB. Если вы можете восстановить отрыв приспособления и сделать его исключительным для сбоев, используйте утверждения вместо этого .

Фатальные утверждения предотвращают сбои ложных тестов из-за отказа фундаментального теста. Они также предотвращают ложные сбои тестирования, когда предыдущий тест не смог восстановить испытательные приборы. Если тестовая инфраструктура не может должным образом разорвать приборы, перезапустите MATLAB, чтобы убедиться, что тестирование может возобновиться в чистом состоянии.

Методы

fatalAssertClass	Неустранимо утверждать точный класс указанного значения
fatalAssertEmpty	Неустранимое утверждение значения пусто
fatalAssertEqual	Неустранимое значение равно указанному значению
fatalAssertError	Неустранимое утверждение функции вызывает указанное исключение
fatalAssertFail	Произвести безусловный фатальный сбой утверждения
fatalAssertFalse	Неустранимое утверждение значения false
fatalAssertGreaterThanOrEqual	Неустранимое значение больше или равно указанному значению
fatalAssertInstanceOf	Неустранимое значение является объектом указанного типа
fatalAssertLength	Неустранимое утверждение значения имеет заданную длину
fatalAssertLessThan	Неустранимое значение меньше указанного
fatalAssertLessThanOrEqual	Неустранимое значение меньше или равно указанному значению
fatalAssertMatches	Неустранимое утверждение соответствия строки указанному регулярному выражению
fatalAssertNotEmpty	Неустранимое утверждение значения не является пустым
fatalAssertNotEqual	Неустранимое значение не равно указанному
fatalAssertNotSameHandle	Неустранимое утверждение значения не обрабатывается указанным экземпляром
fatalAssertNumElements	Неустранимое утверждение значения имеет указанное число элементов
fatalAssertReturnsTrue	Неустранимая функция возвращает значение true при вычислении
fatalAssertSameHandle	Неустранимое утверждение двух значений является дескриптором одного экземпляра
fatalAssertSize	Неустранимое утверждение значения имеет указанный размер
fatalAssertSubstring	Неустранимая строка утверждения содержит указанную строку
fatalAssertThat	Неустранимое утверждение значения соответствует указанному ограничению
fatalAssertTrue	Фатально утверждать значение true
fatalAssertWarning	Неустранимое утверждение ошибок функции с указанными предупреждениями
fatalAssertWarningFree	Неустранимое утверждение функции не выдает предупреждений

События

`FatalAssertionFailed`	Срабатывает при неудачном роковом утверждении. A `QualificationEventData` передается функциям обратного вызова прослушивателя.
`FatalAssertionPassed`	Срабатывает при прохождении рокового утверждения. A `QualificationEventData` передается функциям обратного вызова прослушивателя.

Копирование семантики

Ручка. Сведения о том, как классы обработки влияют на операции копирования, см. в разделе Копирование объектов.

Примеры

свернуть все

Функция помощника по записи с использованием фатальных утверждений

Неустранимое утверждение делает оставшуюся часть текущего метода проверки недопустимой, поскольку состояние не восстанавливается. Вспомогательная функция - это функция в TestCase класс, но не расположенный ни в одном из methods оператор block. Выполнение этих функций не контролируется matlab.unittest рамки.

Добавить DocPolynomSaveLoadTest.m в папку на вашем пути MATLAB. Обратитесь к функции помощника. cleanUpTemporaryFolder, в DocPolynomSaveLoadTest тестовый случай.

Файл определения класса DocPolynomStartLoadTest

classdef DocPolynomSaveLoadTest < matlab.unittest.TestCase 
    
    methods (TestClassSetup) 
        function addDocPolynomClassToPath(testCase) 
            origPath = path; 
            testCase.addTeardown(@path, origPath); 
            addpath(fullfile(matlabroot, ... 
                'help', 'techdoc', 'matlab_oop', 'examples')); 
        end 
    end 
     
    methods (Test) 
        function testSaveLoad(testCase) 
             
            import matlab.unittest.diagnostics.Diagnostic; 
             
            %% Phase 1: Setup 
            % Create a temporary working folder 
            tempFolder = tempname; 
            [success, message] = mkdir(tempFolder); 
            testCase.assertTrue(success, ... 
                Diagnostic.join('Could not create temporary folder.',... 
                message)); 
            testCase.addTeardown(@() testCase.cleanUpTemporaryFolder(...
                tempFolder)); 
             
            % Change to the temporay folder and register the 
            % teardown, which restores the original folder 
            origFolder = pwd; 
            testCase.addTeardown(@cd, origFolder); 
            cd(tempFolder); 
             
            %% Phase 2: Exercise 
            % Save the instance to a mat file. 
            p = DocPolynom([1, 0, 1]); 
            save('DocPolynomFile', 'p'); 
             
            % Validate Precondition. Save resulted in valid .mat file 
            testCase.assertEqual(exist('DocPolynomFile.mat','file'),... 
                2, Diagnostic.join(...
                'mat file was not saved correctly.',@() dir(pwd))); 
             
            loaded = load('DocPolynomFile'); 
             
             
            %% Phase 3: Verify             
            testCase.verifyEqual(loaded.p, p,...
                'Loaded polynom did not equal original polynom.');
             
             
            %% Phase 4: Teardown 
            % Done inline via calls to addTeardown at the points
            % at which the state was changed. 

             
        end 
    end 
     
    methods(Access=private) 
        function cleanUpTemporaryFolder(testCase,tempFolder)
            % Clean up the temporary folder and fatally assert
            % that it was correctly cleaned up.
             
            import matlab.unittest.diagnostics.Diagnostic; 
             
            [success, message] = rmdir(tempFolder, 's'); 
            testCase.fatalAssertTrue(success, ... 
                Diagnostic.join('Could not remove temporary folder.',... 
                message)); 
        end 
    end 
             
end

Сделать cleanUpTemporaryFolder функция-помощник, помещая ее в отдельный methods блок.

methods(Access=private) 
    function cleanUpTemporaryFolder(testCase, tempFolder) 
        % code 
    end 
end

Используйте fatalAssertTrue способ тестирования rmdir success аргумент для ошибок. Если возникает неустранимое утверждение, тестовый запуск прерывается.

function cleanUpTemporaryFolder(testCase, tempFolder) 
     
    import matlab.unittest.diagnostics.Diagnostic
     
    [success, message] = rmdir(tempFolder, 's'); 
    testCase.fatalAssertTrue(success, ... 
        Diagnostic.join('Could not remove the temporary folder.',... 
        message))
end

Если rmdir сбой функции, то этот тест не смог восстановить состояние MATLAB и машины при начальном запуске. Прерывание предотвращает сбой последующих тестов, поскольку этот тест оставляет MATLAB в неожиданном состоянии.

Подробнее

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

Исключение безопасно

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

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

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

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

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

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

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

См. также

Темы

Таблица проверок, утверждений и других квалификаций

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

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