Создайте пользовательское ограничение

В этом примере показано, как создать пользовательское ограничение, которое определяет, имеет ли заданное значение тот же размер, что и ожидаемое значение.

В файле в текущей папке создайте класс с именем HasSameSizeAs который происходит от matlab.unittest.constraints.Constraint класс. Конструктор классов принимает ожидаемое значение, размер которого сравнивается с размером фактического значения. Ожидаемое значение сохранено в ValueWithExpectedSize свойство. Рекомендуемая практика состоит в том, чтобы сделать Constraint реализации неизменяемы, поэтому установите свойство SetAccess атрибут к immutable.

classdef HasSameSizeAs < matlab.unittest.constraints.Constraint
    
    properties(SetAccess = immutable)
        ValueWithExpectedSize
    end
    
    methods
        function constraint = HasSameSizeAs(value)
            constraint.ValueWithExpectedSize = value;
        end
    end
    
end

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

methods(Access = private)
    function bool = sizeMatchesExpected(constraint,actual)
        bool = isequal(size(actual),size(constraint.ValueWithExpectedSize));
    end
end

Классы, которые получают из matlab.unittest.constraints.Constraint класс должен переопределить satisfiedBy способ. Этот метод должен содержать логику сравнения и вернуть логическое значение. В пределах methods блокируйте, реализуйте satisfiedBy при вызове вспомогательного метода. Если фактический размер и ожидаемый размер равны, метод возвращается true.

methods
    function bool = satisfiedBy(constraint,actual)
        bool = constraint.sizeMatchesExpected(actual);
    end
end

Классы, которые получают из matlab.unittest.constraints.Constraint класс должен также переопределить getDiagnosticFor способ. Этот метод должен вычислить фактическое значение относительно ограничения и предоставить Diagnostic объект. В этом примере getDiagnosticFor возвращает StringDiagnostic объект.

methods        
    function diag = getDiagnosticFor(constraint,actual)
        import matlab.unittest.diagnostics.StringDiagnostic
        if constraint.sizeMatchesExpected(actual)
            diag = StringDiagnostic('HasSameSizeAs passed.');
        else
            diag = StringDiagnostic(sprintf(...
                'HasSameSizeAs failed.\nActual Size: [%s]\nExpectedSize: [%s]',...
                int2str(size(actual)),...
                int2str(size(constraint.ValueWithExpectedSize))));
        end
    end
end

Определение класса HasSameSizeAs

Это полный код для HasSameSizeAs класс.

classdef HasSameSizeAs < matlab.unittest.constraints.Constraint
    
    properties(SetAccess = immutable)
        ValueWithExpectedSize
    end
    
    methods
        function constraint = HasSameSizeAs(value)
            constraint.ValueWithExpectedSize = value;
        end
        
        function bool = satisfiedBy(constraint,actual)
            bool = constraint.sizeMatchesExpected(actual);
        end
        
        function diag = getDiagnosticFor(constraint,actual)
            import matlab.unittest.diagnostics.StringDiagnostic
            if constraint.sizeMatchesExpected(actual)
                diag = StringDiagnostic('HasSameSizeAs passed.');
            else
                diag = StringDiagnostic(sprintf(...
                    'HasSameSizeAs failed.\nActual Size: [%s]\nExpectedSize: [%s]',...
                    int2str(size(actual)),...
                    int2str(size(constraint.ValueWithExpectedSize))));
            end
        end
    end
    
    methods(Access = private)
        function bool = sizeMatchesExpected(constraint,actual)
            bool = isequal(size(actual),size(constraint.ValueWithExpectedSize));
        end
    end
    
end

Тест на ожидаемый размер

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

import matlab.unittest.TestCase
testCase = TestCase.forInteractiveUse;

Протестируйте проходящий случай.

testCase.verifyThat(zeros(5),HasSameSizeAs(repmat(1,5)))

Verification passed.

Протестируйте неисправный случай.

testCase.verifyThat(zeros(5),HasSameSizeAs(ones(1,5)))

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    HasSameSizeAs failed.
    Actual Size: [5  5]
    ExpectedSize: [1  5]

См. также

getDiagnosticFor | matlab.unittest.constraints.Constraint | matlab.unittest.diagnostics.Diagnostic | matlab.unittest.diagnostics.StringDiagnostic | satisfiedBy

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