클래스 기반 테스트에서 파라미터 사용하기

테스트 데이터 면에서만 다른 일련의 테스트를 실행해야 하는 경우가 많습니다. 예를 들어, 함수가 다른 입력값에 대해 예상 출력값을 생성하는지 테스트해 보려고 할 수 있습니다. 이 경우 테스트 로직은 동일하며 테스트 간의 유일한 차이는 각 함수 호출에 대한 실제값과 예상값입니다. 파라미터화된 테스트를 통해 서로 다른 데이터 값을 사용하여 반복적으로 테스트를 실행하는 코드를 구현할 수 있습니다. 메서드가 파라미터화된 경우 테스트 프레임워크는 자동으로 각 파라미터 값에 대한 메서드를 호출합니다. 따라서 각각의 값에 대해 별도의 메서드를 구현할 필요가 없습니다.

테스트 프레임워크를 사용하면 다른 여러 수준에서 테스트 클래스를 파라미터화할 수 있습니다. 또한 여러 개의 파라미터를 사용하여 테스트 클래스 메서드를 호출할 때 다양한 파라미터 조합에 대해 메서드가 호출되는 방법을 지정할 수 있습니다.

파라미터화된 테스트를 작성하는 방법

matlab.unittest.TestCase 클래스에서 파생되는 클래스는 프레임워크별 속성과 메서드 특성을 사용하여 테스트 파라미터화를 구현할 수 있습니다. 클래스 기반 테스트에서 데이터를 파라미터로 제공하려면 properties 블록을 사용하여 데이터에 적절한 파라미터화 특성을 지정하십시오. 그런 다음 하나 이상의 메서드에 파라미터화 속성을 입력 인수로 전달합니다.

예를 들어, SampleTest 클래스를 살펴보겠습니다. 이 클래스는 properties 블록 내의 속성에 TestParameter 특성을 지정하므로 파라미터화된 테스트를 정의합니다. 속성은 Test 메서드에 전달되고 가설 검정(Qualification)을 수행하는 데 사용됩니다.

classdef SampleTest < matlab.unittest.TestCase
    properties (TestParameter)
        numericArray = {int16(1),single(zeros(1,4)),magic(3)};
        functionHandle = {@false,@() size([])};
    end
    methods (Test)
        function test1(testCase,numericArray)
            testCase.verifyNotEmpty(numericArray)
        end
        function test2(testCase,functionHandle)
            testCase.verifyWarningFree(functionHandle)
        end
    end
end

테스트 클래스를 통해 요소가 5개인 파라미터화된 테스트 스위트가 생성됩니다.

suite = testsuite("SampleTest");
{suite.Name}'

ans =

  5×1 cell array

    {'SampleTest/test1(numericArray=int16_1)'          }
    {'SampleTest/test1(numericArray=1x4_single)'       }
    {'SampleTest/test1(numericArray=3x3_double)'       }
    {'SampleTest/test2(functionHandle=@false)'         }
    {'SampleTest/test2(functionHandle=function_handle)'}

파라미터화 속성의 값을 비어 있지 않은 셀형 배열 또는 필드가 하나 이상인 스칼라 구조체로 지정합니다. 테스트 프레임워크는 속성값을 사용하여 테스트 스위트의 파라미터 이름과 값을 지정합니다.

속성값이 셀형 배열인 경우 프레임워크는 값, 유형, 차원을 고려하여 셀형 배열의 요소로부터 설명적인 파라미터 이름을 생성합니다.
속성값이 구조체인 경우 구조체 필드는 파라미터 이름을 나타내고 구조체 값은 파라미터 값을 나타냅니다. 스위트의 파라미터 이름을 완전히 제어하려면 셀형 배열 대신 구조체를 사용하여 파라미터를 정의하십시오.

참고

MATLAB^® Test™ 라이선스가 있는 경우, 파라미터화 속성을 matlabtest.parameters.BaselineParameter 객체로 설정하여 기준 테스트를 실행할 수 있습니다. 자세한 내용은 Create Baseline Tests for MATLAB Code (MATLAB Test) 항목을 참조하십시오. (R2024b 이후)

파라미터화 속성을 초기화하는 방법

파라미터화 속성을 정의할 때 MATLAB이 파라미터 이름과 값을 생성할 수 있도록 속성을 초기화해야 합니다. 테스트 클래스를 불러올 때나 테스트 스위트를 생성할 때 속성을 초기화할 수 있습니다.

클래스 불러오기 시: MATLAB에서 테스트 클래스 정의를 불러올 때 속성값을 확인할 수 있는 경우 디폴트 값을 사용하여 속성을 초기화합니다. properties 블록에 디폴트 값을 지정하거나 classdef 파일에 로컬 함수를 사용하여 디폴트 값을 지정할 수 있습니다. 클래스 정의에 값을 할당하는 방법에 대한 자세한 내용은 Evaluation of Expressions in Class Definitions 항목을 참조하십시오.
클래스를 불러올 때 파라미터화 속성을 초기화하면 이 속성과 연결된 파라미터가 각 테스트 실행마다 고정된 상태로 유지됩니다. 파라미터화된 테스트 클래스에서 스위트를 생성할 때마다 프레임워크가 동일한 파라미터 이름과 값을 사용하여 테스트를 실행합니다. 파라미터화 속성에 디폴트 값을 사용하는 예제는 파라미터화된 기본 테스트 생성하기 항목을 참조하십시오.
스위트 생성 시: 클래스를 불러올 때 파라미터를 확인할 수 없거나 이를 원치 않는 경우 스위트 생성 시 정적 메서드와 함께 TestParameterDefinition 특성을 사용하여 속성을 초기화하십시오. TestParameterDefinition 메서드를 사용하여 파라미터화 속성을 초기화하면 이 속성과 연결된 파라미터가 각 테스트 실행마다 달라질 수 있습니다. 파라미터화된 테스트 클래스에서 스위트를 생성할 때마다 프레임워크가 새로운 파라미터 이름과 값을 생성하여 테스트를 실행합니다. 자세한 내용은 스위트 생성 시 파라미터 정의하기 항목을 참조하십시오.

참고

파라미터화 속성에 값을 할당한 후에는 수정하지 마십시오. 예를 들어, 디폴트 값을 사용하여 파라미터화 속성을 초기화하면 TestParameterDefinition 메서드를 사용하여 디폴트 값을 덮어쓸 수 없습니다.

하나의 파라미터를 여러 단위 테스트에서 사용할 수 있습니다. 동일한 파라미터를 사용하는 테스트는 서로 실수로 영향을 미치지 않도록 독립적으로 실행되어야 합니다. 또한, 실행되는 테스트가 동일한 테스트의 후속 재실행에 영향을 주지 않아야 합니다. 테스트 실행의 독립성이 보장되도록 값 객체를 사용하여 파라미터화 속성을 초기화하십시오. 핸들 객체(예: MATLAB 그래픽스 객체)를 파라미터 값으로 사용하는 것은 권장되지 않습니다. 값 객체 및 핸들 객체의 동작에 대한 자세한 내용은 핸들 클래스와 값 클래스 비교 항목을 참조하십시오.

파라미터화된 테스트에서 핸들 객체를 테스트해야 할 경우에는 함수 핸들을 파라미터 값으로서 간접적으로 생성하고 테스트에서 이러한 함수 핸들을 호출할 수 있습니다. 예를 들어, 파라미터화된 테스트를 작성하여 figure 및 uifigure 함수를 사용하여 만든 Figure의 디폴트 현재 점을 테스트해 보겠습니다.

classdef FigureTest < matlab.unittest.TestCase
    properties (TestParameter)
        figureType = {@figure,@uifigure};
    end
    methods (Test)
        function defaultCurrentPoint(testCase,figureType)
            fig = figureType();
            testCase.addTeardown(@close,fig)
            cp = fig.CurrentPoint;
            testCase.verifyEqual(cp,[0 0])
        end
    end
end

파라미터화 수준 지정하기

클래스 설정, 메서드 설정 및 테스트의 세 가지 수준에서 테스트 클래스를 파라미터화할 수 있습니다. 각 수준에서 파라미터화하려면 파라미터화 속성에 특정한 속성 특성이 있어야 합니다. 예를 들어, 가장 높은 수준에서 TestClassSetup 메서드는 ClassSetupParameter 특성이 있는 properties 블록에 정의된 속성을 사용하여 파라미터화할 수 있습니다. 가장 낮은 수준에서 Test 메서드는 TestParameter 특성이 있는 properties 블록에 정의된 속성을 사용하여 파라미터화할 수 있습니다.

다음 표에는 다양한 파라미터화 수준과 각 수준에 필요한 메서드 및 속성 특성이 나와 있습니다.

파라미터화 수준	파라미터화 정의		액세스 가능한 파라미터화 속성
파라미터화 수준	메서드 특성	속성 특성	액세스 가능한 파라미터화 속성
클래스 설정 수준	`TestClassSetup`	`ClassSetupParameter`	`ClassSetupParameter`
메서드 설정 수준	`TestMethodSetup`	`MethodSetupParameter`	`MethodSetupParameter` 및 `ClassSetupParameter`
테스트 수준	`Test`	`TestParameter`	`TestParameter`, `MethodSetupParameter`, `ClassSetupParameter`

파라미터화된 메서드는 메서드가 정의된 수준에 따라 파라미터화 속성에 액세스할 수 있습니다.

파라미터화된 TestClassSetup 메서드는 ClassSetupParameter 특성만 있는 파라미터화 속성에 액세스할 수 있습니다.
파라미터화된 TestMethodSetup 메서드는 MethodSetupParameter 특성 또는 ClassSetupParameter 특성만 있는 파라미터화 속성에 액세스할 수 있습니다.
파라미터화된 Test 메서드는 모든 파라미터화 속성에 액세스할 수 있습니다.

다른 수준에서 테스트 클래스를 파라미터화하는 방법에 대한 예는 파라미터화된 고급 테스트 생성하기 항목을 참조하십시오.

파라미터 조합 방법 지정하기

둘 이상의 파라미터화 속성을 메서드에 전달하는 경우 ParameterCombination 메서드 특성을 사용하여 파라미터 조합 방법을 지정할 수 있습니다. 테스트 프레임워크는 지정된 조합에 대한 메서드를 호출합니다.

다음 표에는 다양한 파라미터 조합 전략이 나와 있습니다.

ParameterCombination 특성 값 메서드 호출

"exhaustive"(디폴트 값)

모든 파라미터 값 조합에 대해 메서드를 불러옵니다. ParameterCombination 특성을 지정하지 않는 경우, 테스트 프레임워크는 이 디폴트 조합을 사용합니다.

"sequential"

대응하는 파라미터 값을 사용하여 메서드가 호출됩니다. 파라미터화 속성은 동일한 개수의 파라미터 값을 지정해야 합니다. 예를 들어, 메서드에 두 개의 파라미터화 속성이 제공되고 각 속성이 세 개의 파라미터 값을 지정하는 경우 프레임워크는 메서드를 세 번 호출합니다.

"pairwise"

모든 파라미터 값 쌍에 대해 적어도 한 번은 메서드가 호출됩니다. 완전 조합에 비해 쌍별 조합은 일반적으로 테스트 수가 더 적으므로 테스트 실행 속도가 더 빠릅니다.

예를 들어, 이 테스트에서는 쌍별 조합을 사용하여 서로 다른 행렬의 크기를 테스트합니다.

classdef ZerosTest < matlab.unittest.TestCase
    properties (TestParameter)
        rowCount = struct("r1",1,"r2",2,"r3",3);
        columnCount = struct("c1",2,"c2",3,"c3",4);
        type = {'single','double','uint16'};
    end
    methods (Test,ParameterCombination="pairwise")
        function testSize(testCase,rowCount,columnCount,type)
            testCase.verifySize(zeros(rowCount,columnCount,type), ...
                [rowCount columnCount])
        end
    end
end

클래스로부터 테스트 스위트를 만듭니다. 가능한 결과 하나에는 아래에 나열된 10개의 요소가 포함됩니다.

suite = testsuite("ZerosTest");
{suite.Name}'

ans =

  10×1 cell array

    {'ZerosTest/testSize(rowCount=r1,columnCount=c1,type=single)'}
    {'ZerosTest/testSize(rowCount=r1,columnCount=c2,type=double)'}
    {'ZerosTest/testSize(rowCount=r1,columnCount=c3,type=uint16)'}
    {'ZerosTest/testSize(rowCount=r2,columnCount=c1,type=double)'}
    {'ZerosTest/testSize(rowCount=r2,columnCount=c2,type=single)'}
    {'ZerosTest/testSize(rowCount=r2,columnCount=c3,type=single)'}
    {'ZerosTest/testSize(rowCount=r3,columnCount=c1,type=uint16)'}
    {'ZerosTest/testSize(rowCount=r3,columnCount=c2,type=single)'}
    {'ZerosTest/testSize(rowCount=r3,columnCount=c3,type=double)'}
    {'ZerosTest/testSize(rowCount=r2,columnCount=c2,type=uint16)'}

테스트 프레임워크는 두 개의 속성으로 지정된 모든 파라미터 값 조합에 대해 testSize 메서드가 호출되도록 합니다. 예를 들어 rowCount 속성과 columnCount 속성에 대해 이 표에는 파라미터 값 조합에 해당하는 TestSuite 배열 인덱스가 나와 있습니다. 모든 조합은 하나 이상의 Test 요소로 표현됩니다.

—		`columnCount` 속성
—		`c1`	`c2`	`c3`
`rowCount` 속성	`r1`	1	2	3
	`r2`	4	5, 10	6
	`r3`	7	8	9

프레임워크가 한 쌍의 값마다 적어도 한 번은 테스트가 생성되도록 하지만, 사용자는 스위트 크기, 순서, 특정 테스트 스위트 요소 집합만 고려해서는 안 됩니다.

"n-wise"

파라미터 값의 n-튜플마다 적어도 한 번 메서드가 호출됩니다(MATLAB Test 필요). n은 2에서 10 사이의 정수로 지정할 수 있습니다. 예를 들어, 파라미터 값의 4배마다 적어도 한 번은 메서드를 호출하려면 특성을 "4-wise"로 지정합니다.

"2-wise" 및 "pairwise" 특성 값을 서로 구분 없이 사용할 수 있습니다. "n-wise" 파라미터 조합은 쌍별 조합을 일반화하고, 일반적으로 완전 조합에 비해 테스트 수가 더 적으므로 테스트 실행 속도가 더 빠릅니다. 프레임워크가 값의 n-튜플마다 적어도 한 번은 테스트가 생성되도록 하지만, 사용자는 스위트 크기, 순서, 특정 테스트 스위트 요소 집합만 고려해서는 안 됩니다.

클래스 설정 수준, 메서드 설정 수준 및 테스트 수준에서 파라미터를 조합할 수 있습니다. 예를 들어, MethodSetupParameter 특성이 있는 properties 블록에 정의된 메서드 설정 수준 파라미터의 순차적 조합을 지정하려면, 두 메서드 특성 TestMethodSetup,ParameterCombination="sequential"을 사용하십시오.

테스트 파라미터를 조합하는 방법의 예는 파라미터화된 기본 테스트 생성하기 및 파라미터화된 고급 테스트 생성하기 항목을 참조하십시오.

테스트에 외부 파라미터 사용하기

파라미터화된 테스트를 만들 때 클래스 기반 테스트에 입력값을 주입하여 파라미터를 다시 정의할 수 있습니다. 테스트 파일 외부에 정의된 데이터를 제공하려면 테스트 스위트를 만들 때 Parameter 인스턴스를 만들고 ExternalParameter 이름-값 인수를 사용하십시오. 자세한 내용은 파라미터화된 테스트에 외부 파라미터 사용하기 항목을 참조하십시오.