Exponenta Banner

Динамически фильтрованные тесты

Предположение отказов привести к filtered tests. В matlab.unittest.TestResult класс, такой тест отмечен Incomplete.

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

Методы тестирования

Если отказ допущения встречается внутри TestCase метод с Test атрибут, весь метод помечен как отфильтрованный, но MATLAB® запускает последующие Test методы.

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

classdef ExampleTest < matlab.unittest.TestCase
    methods(Test)
        function testA(testCase)
            testCase.verifyTrue(true)
        end
        function testB(testCase)
            testCase.assumeEqual(0,1)
            % remaining test code is not exercised
        end
        function testC(testCase)
            testCase.verifyFalse(true)
        end
    end
end

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

ts = matlab.unittest.TestSuite.fromClass(?ExampleTest);
res = ts.run;
Running ExampleTest
.
================================================================================
ExampleTest/testB was filtered.
Details
================================================================================
.
================================================================================
Verification failed in ExampleTest/testC.

    ---------------------
    Framework Diagnostic:
    ---------------------
    verifyFalse failed.
    --> The value must evaluate to "false".
    
    Actual logical:
           1

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

Failure Summary:

     Name               Failed  Incomplete  Reason(s)
    ================================================================
     ExampleTest/testB              X       Filtered by assumption.
    ----------------------------------------------------------------
     ExampleTest/testC    X                 Failed by verification.

Если вы исследуете TestResultвы заметили, что существует пройденный тест, неудачный тест и тест, который не был завершен из-за отказа допущения.

res
res = 

  1×3 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   1 Passed, 1 Failed, 1 Incomplete.
   2.4807 seconds testing time.

Среда тестирования отслеживает неполные тесты, чтобы вы могли контролировать отфильтрованные тесты на наличие неэксперсного тестового кода. Вы можете увидеть информацию об этих тестах в TestResult объект.

res([res.Incomplete])
ans = 

  TestResult with properties:

          Name: 'ExampleTest/testB'
        Passed: 0
        Failed: 0
    Incomplete: 1
      Duration: 2.2578
       Details: [1×1 struct]

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

Чтобы создать измененный тестовый набор только из отфильтрованных тестов, выберите неполные тесты из исходного тестового набора.

tsFiltered = ts([res.Incomplete])
tsFiltered = 

  Test with properties:
                  Name: 'ExampleTest/testB'
         ProcedureName: 'testB'
             TestClass: "ExampleTest"
            BaseFolder: 'C:\work'
      Parameterization: [0×0 matlab.unittest.parameters.EmptyParameter]
    SharedTestFixtures: [0×0 matlab.unittest.fixtures.EmptyFixture]
                  Tags: {1×0 cell}

Tests Include:
   0 Parameterizations, 0 Shared Test Fixture Classes, 0 Tags.

Setup и отключения метода

Если отказ допущения встречается внутри TestCase метод с TestMethodSetup атрибут, MATLAB фильтрует метод, который должен был быть запущен для этого образца. Если тест использует допущения из TestMethodSetup блокируйте, рассмотрите вместо этого использование допущений в TestClassSetup блок, который также фильтрует все Test методы в классе, но менее подробны и более эффективны.

Один из методов следующего TestMethodSetup блок внутри ExampleTest.m содержит отказ допущения.

    methods(TestMethodSetup)
        function setupMethod1(testCase)
            testCase.assumeEqual(1,0)
            % remaining test code is not exercised
        end
        function setupMethod2(testCase)
            disp('* Running setupMethod2 *')
            testCase.assertEqual(1,1)
        end
    end

 Обновленный ExampleTest Определение класса

Когда вы запускаете тест, вы видите, что среда завершает выполняет все методы в TestMethodSetup блок, который не содержит отказа допущения и помечает как неполные все методы в Test блок.

ts = matlab.unittest.TestSuite.fromClass(?ExampleTest);
res = ts.run;
Running ExampleTest

================================================================================
ExampleTest/testA was filtered.
    Details
================================================================================
* Running setupMethod2 *
.
================================================================================
ExampleTest/testB was filtered.
    Details
================================================================================
* Running setupMethod2 *
.
================================================================================
ExampleTest/testC was filtered.
    Details
================================================================================
* Running setupMethod2 *
.
Done ExampleTest
__________

Failure Summary:

     Name               Failed  Incomplete  Reason(s)
    ================================================================
     ExampleTest/testA              X       Filtered by assumption.
    ----------------------------------------------------------------
     ExampleTest/testB              X       Filtered by assumption.
    ----------------------------------------------------------------
     ExampleTest/testC              X       Filtered by assumption.

The Test методы не изменились, но все 3 фильтруются из-за отказа допущения в TestMethodSetup блок. Среда тестирования выполняет методы в TestMethodSetup блок без отказов предположений, таких как setupMethod2. Как и ожидалось, среда тестирования выполняет setupMethod2 3 раза, один раз перед каждым Test способ.

Setup и отключения

Если отказ допущения встречается внутри TestCase метод с TestClassSetup или TestClassTeardown атрибут, MATLAB фильтрует все TestCase класс.

Методы, описанные ниже TestClassSetup блок внутри ExampleTest.m содержит отказ допущения.

    methods(TestClassSetup)
        function setupClass(testCase)
            testCase.assumeEqual(1,0)
            % remaining test code is not exercised
        end
    end

 Обновленный ExampleTest Определение класса

Когда вы запускаете тест, вы видите, что среда не выполняет ни один из методов в TestMethodSetup или Test.

ts = matlab.unittest.TestSuite.fromClass(?ExampleTest);
res = ts.run;
Running ExampleTest

================================================================================
All tests in ExampleTest were filtered.
    Details
================================================================================

Done ExampleTest
__________

Failure Summary:

     Name               Failed  Incomplete  Reason(s)
    ================================================================
     ExampleTest/testA              X       Filtered by assumption.
    ----------------------------------------------------------------
     ExampleTest/testB              X       Filtered by assumption.
    ----------------------------------------------------------------
     ExampleTest/testC              X       Filtered by assumption.

The Test и TestMethodSetup методы не изменились, но все фильтруется из-за предположения, отказа в TestClassSetup блок.

См. также

| |

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

Поддержка