TAP::Formatter::Base - 測試架構輸出代理的基底類別
版本 3.44
這為 TAP::Harness 提供面向主控台的輸出格式化。
use TAP::Formatter::Console;
my $harness = TAP::Formatter::Console->new( \%args );
new
my %args = (
verbose => 1,
)
my $harness = TAP::Formatter::Console->new( \%args );
建構函式傳回一個新的 TAP::Formatter::Console
物件。如果 TAP::Harness 在沒有 formatter
的情況下建立,則會自動建立一個 TAP::Formatter::Console
。如果 TAP::Harness->new 獲得以下任何選項,它們將傳遞給這個建構函式,它接受一個選用的雜湊參考,其允許的鍵為
verbosity
設定詳細程度。
verbose
將個別測試結果列印到 STDOUT。
timer
將每個測試的執行時間附加到輸出。如果可用,會使用 Time::HiRes。
failures
顯示測試失敗(如果選取 verbose
,這是一個空操作)。
註解
顯示測試註解(如果選擇 verbose
,這是一個空操作)。
quiet
抑制部分測試輸出(主要是在測試執行期間的失敗)。
really_quiet
抑制所有內容,但測試摘要除外。
silent
抑制所有輸出。
errors
如果在 TAP 輸出中找到解析錯誤,摘要報告中會註明這一點。若要查看所有解析錯誤,請將此參數設定為 true
errors => 1
directives
如果設定為 true 值,則只會顯示具有指令的測試結果。這會覆寫其他設定,例如 verbose
、failures
或 comments
。
stdout
用於擷取標準輸出的檔案句柄。
color
如果已定義,則指定是否需要彩色輸出。如果未定義 color
,如果當前平台支援彩色輸出且輸出未重新導向,則預設為彩色輸出。
jobs
此格式化程式將處理的同時工作數。
show_count
布林值。如果為 false,則停用測試執行期間顯示的 X/Y
測試計數。
任何值為 undef
的鍵值都會被忽略。
prepare
在產生任何測試輸出之前由 Test::Harness 呼叫。
這是一個建議,在 Test::Harness 透過反覆運算提供測試的情況下,可能不會呼叫。
open_test
呼叫以建立新的測試階段。測試階段看起來像這樣
my $session = $formatter->open_test( $test, $parser );
while ( defined( my $result = $parser->next ) ) {
$session->result($result);
exit 1 if $result->is_bailout;
}
$session->close_test;
summary
$harness->summary( $aggregate );
summary
在執行所有測試後列印摘要報告。第一個參數是要總結的彙總。可以將第二個參數(選用)設定為 true 值,以指出摘要是因中斷測試執行而輸出的。