Test2::EventFacet::Info - 開發人員可能關心的資訊切面。
此切面代表傳達給人類的訊息,將協助他們了解結果或診斷失敗。
此切面會顯示在清單中,而不是單一項目。
人類可讀的字串或資料結構,這是要顯示的資訊。格式化程式可以自由地呈現結構。這可能會包含一個受祝福的物件。
如果設定了 table
屬性(見下方),則呈現程式可能會選擇顯示表格,而不是詳細資料。
如果 info
切面需要傳達的資料可以表示為表格,則資料可能會以更原始的形式放置在此屬性中,以利於更好的顯示。資料也必須表示在 details
屬性中,供不支援直接呈現表格的呈現程式使用。
表格結構
my %table = {
header => [ 'column 1 header', 'column 2 header', ... ], # Optional
rows => [
['row 1 column 1', 'row 1, column 2', ... ],
['row 2 column 1', 'row 2, column 2', ... ],
...
],
# Allow the renderer to hide empty columns when true, Optional
collapse => $BOOL,
# List by name or number columns that should never be collapsed
no_collapse => \@LIST,
}
簡短標籤用於分類資訊。通常長度為 10 個字元或更少,格式化程式可能會截斷較長的標籤。
如果訊息很關鍵,或說明了失敗,請將此設定為 true。這是格式化程式即使在較不詳細的模式下也應顯示的資訊。
如果為 false,則資訊不會被視為關鍵,且可能不會在較不詳細的模式下呈現。
這應設定為非除錯訊息,但仍足夠重要,以便在格式化程式處於靜音模式時顯示。格式化程式應將這些訊息傳送至 STDOUT,而非 STDERR,但即使在非詳細模式下也應顯示這些訊息。
Test2 的原始碼儲存庫可在 http://github.com/Test-More/test-more/ 找到。
著作權所有 2020 Chad Granum <exodist@cpan.org>。
此程式為自由軟體;您可以在與 Perl 相同的條款下重新散布或修改它。
請參閱 http://dev.perl.org/licenses/