matlab.unittest.qualifications.FatalAssertable class

Пакет: matlab.unittest.qualifications

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

Описание

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

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

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

Методы

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

События

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

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

Указатель. Чтобы узнать, как классы Handle влияют на операции копирования, см. раздел "Копирование объектов".

Примеры

свернуть все

Запись функции помощника Используя критические утверждения

Критическое утверждение представляет остаток от текущего метода тестирования, недопустимого, потому что состояние неисправимо. helper function является функцией в TestCase класс, но не расположенный в любом methods оператор блока. Выполнением этих функций не управляет matlab.unittest среда.

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

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

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 покидает в неожиданном состоянии этот тест.

Больше о

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

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

Содержанием теста является exception safe, когда все отключение фиксатора выполняется с 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)

Темы

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

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