스크립트 기반 테스트 확장하기

통상적으로 스크립트 기반 테스트에서는 Test 객체 모음을 명시적으로 생성하지 않고, 테스트 파일을 만들어 이 파일 이름을 runtests 함수로 전달합니다. 명시적인 테스트 스위트를 생성한 경우 스크립트 기반 테스트에서 추가 기능을 사용할 수 있습니다. 추가 기능에는 테스트 선택, 플러그인을 사용한 테스트 실행기 사용자 지정 등이 있습니다. 그 외 추가 기능이 필요하다면 함수 기반 단위 테스트나 클래스 기반 단위 테스트 사용을 고려하십시오.

테스트 스위트 생성하기

스크립트 기반 테스트에서 직접 테스트 스위트를 생성하려면 testsuite 함수를 사용하십시오. 더욱 명시적인 테스트 스위트를 생성하려면 TestSuite의 matlab.unittest.TestSuite.fromFile 메서드를 사용하십시오. 그러면 runtests 함수 대신, run 메서드를 사용하여 테스트를 실행할 수 있습니다. 예를 들어, 파일 rightTriTolTest.m에 스크립트 기반 테스트가 있는 경우 다음 세 가지 접근 방식은 동일합니다.

% Implicit test suite
result = runtests('rightTriTolTest.m');

% Explicit test suite
suite = testsuite('rightTriTolTest.m');
result = run(suite);

% Explicit test suite
suite = matlab.unittest.TestSuite.fromFile('rightTriTolTest.m');
result = run(suite);

또한 matlab.unittest.TestSuite.fromFolder 메서드를 사용하여 지정된 폴더 내 모든 테스트 파일로부터 테스트 스위트를 생성할 수도 있습니다. 스크립트 기반 테스트 파일의 특정 테스트 이름을 알고 있는 경우 matlab.unittest.TestSuite.fromName을 사용하여 해당 테스트에서 테스트 스위트를 생성할 수 있습니다.

테스트 선택

명시적인 테스트 스위트에서는 선택기를 사용하여 테스트 스위트를 구체화할 수 있습니다. 몇 가지 선택기는 클래스 기반 테스트에만 적용할 수 있지만, 다음과 같이 테스트 이름에 따라 스위트의 테스트를 선택할 수 있습니다.

matlab.unittest.TestSuite.fromFile과 같은 스위트 생성 메서드에서 'Name' 이름-값 쌍의 인수를 사용합니다.
selectors 인스턴스와 선택적 constraints 인스턴스를 사용합니다.

matlab.unittest.TestSuite.fromFile과 같은 스위트 생성 메서드에서 이러한 접근 방식을 사용하거나, 스위트를 생성한 후 selectIf 메서드를 사용해 해당 스위트를 필터링합니다. 예를 들어, 아래 목록에서 suite의 네 값은 동일합니다.

import matlab.unittest.selectors.HasName
import matlab.unittest.constraints.ContainsSubstring
import matlab.unittest.TestSuite.fromFile

f = 'rightTriTolTest.m';
selector = HasName(ContainsSubstring('Triangle'));

% fromFile, name-value pair
suite = TestSuite.fromFile(f,'Name','*Triangle*')

% fromFile, selector
suite = TestSuite.fromFile(f,selector)

% selectIf, name-value pair
fullSuite = TestSuite.fromFile(f);
suite = selectIf(fullSuite,'Name','*Triangle*')

% selectIf, selector
fullSuite = TestSuite.fromFile(f);
suite = selectIf(fullSuite,selector)

선택기나 이름-값 쌍을 사용해 이 스위트 생성 메서드 중 하나를 사용하면, 테스트 프레임워크에서는 필터링된 스위트를 생성합니다. selectIf 메서드를 사용하는 경우, 테스트 프레임워크는 전체 테스트 스위트를 생성한 후 이를 필터링합니다. 테스트 스위트가 클 경우, 이 접근 방식은 성능에 영향을 줄 수 있습니다.

테스트 진단에 대한 프로그래밍적 접근

경우에 따라 테스트 프레임워크는 DiagnosticsRecordingPlugin 플러그인을 사용하여 테스트 결과에 대한 진단을 기록합니다. 프레임워크는 사용자가 다음 중 하나를 수행하는 경우 기본적으로 이 플러그인을 사용합니다.

runtests 함수를 사용하여 테스트를 실행합니다.
입력값 없이 testrunner 함수를 사용하여 테스트를 실행합니다.
TestSuite 클래스 또는 TestCase 클래스의 run 메서드를 사용하여 테스트를 실행합니다.
runperf 함수를 사용하여 성능 테스트를 실행합니다.
TimeExperiment 클래스의 run 메서드를 사용하여 성능 테스트를 실행합니다.

테스트를 실행한 후에는 TestResult 객체의 Details 속성에 있는 DiagnosticRecord 필드를 사용하여 기록된 진단에 액세스할 수 있습니다. 예를 들어, 테스트 결과가 변수 results에 저장된 경우 result(2).Details.DiagnosticRecord에 스위트의 두 번째 테스트에 대해 기록된 진단이 포함됩니다.

기록된 진단은 DiagnosticRecord 객체입니다. 테스트에 대한 특정 유형의 테스트 진단에 액세스하려면 DiagnosticRecord 클래스의 selectFailed, selectPassed, selectIncomplete, selectLogged 메서드를 사용하십시오.

기본적으로, DiagnosticsRecordingPlugin 플러그인은 matlab.automation.Verbosity.Terse 세부 정보 표시 수준에서 기록된 이벤트와 가설 검정(Qualification) 실패를 기록합니다. 자세한 내용은 DiagnosticsRecordingPlugin 및 DiagnosticRecord를 참조하십시오.

테스트 실행기를 사용자 지정하기

TestRunner 객체를 사용하여 프레임워크가 테스트 스위트를 실행하는 방법을 사용자 지정합니다. TestRunner 객체를 통해 다음을 수행할 수 있습니다.

withNoPlugins 메서드를 사용하여 명령 창에서 출력값을 생성하지 않을 수 있습니다.
runInParallel 메서드를 사용하여 병렬로 테스트를 실행합니다.
addPlugin 메서드를 사용하여 테스트 실행기에 플러그인을 추가합니다.

예를 들어, 테스트 스위트 suite를 사용하여 자동 테스트 실행기를 생성하고 TestRunner의 run 메서드를 통해 테스트를 실행할 수 있습니다.

runner = matlab.unittest.TestRunner.withNoPlugins;
results = runner.run(suite);

플러그인을 사용하여 테스트 실행기를 추가로 사용자 지정합니다. 예를 들어, 출력값을 리디렉션하거나 코드 실행률을 파악하거나 테스트 실행기에서 경고에 대응하는 방법을 변경할 수 있습니다. 자세한 내용은 테스트 실행기(Test Runner)에 플러그인 추가하기 항목과 plugins 클래스를 참조하십시오.

참고 항목

plugins | selectors | matlab.unittest.constraints | TestRunner | TestSuite