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

Пакет: 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 влияют на операции копирования, см. раздел "Копирование объектов".

Примеры

свернуть все

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

Критическое утверждение представляет остаток от текущего метода тестирования, недопустимого, потому что состояние неисправимо. Функция помощника является функцией в классе 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 покидает в неожиданном состоянии этот тест.

Больше о

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

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

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

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

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

Описание

Методы

События

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

Примеры

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

Больше о

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

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

Темы

Введенный в R2013a

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

Поддержка