Man page - dejagnu-report-card(1)

Packages contains this manual

Available languages:

en ja

Manual

UNTITLED () LOCAL UNTITLED ()

名 前

dejagnu report card — 複 数 ツ ー ル に 対 す る テ ス ト 結 果 の 取 り ま と め

書 式

dejagnu report card [

⟨
option ⟩ | ⟨
tool ⟩ | ⟨
file ⟩ ] ...

説 明

The コ マ ン ド は 、 複 数 ツ ー ル に よ る テ ス ト 結 果 を 表 形 式 で 表 示 し ま す 。 生 成 さ れ る こ の 表 に お い て は 、 以 下 の 項 目 を 一 覧 表 示 し ま す 。 各 ツ ー ル ご と に (そ し て 複 数 パ ス が 実 行 さ れ た 場 合 に は 、 各 パ ス ご と に )、 テ ス ト の 成 功 数 (passed)、 失 敗 数 (failed)、 未 対 応 数 (unsupported)、 未 解 決 数 (unresolved)、 未 実 施 数 (untested) で す 。 失 敗 す る こ と が 予 想 さ れ る テ ス ト は 、 成 功 す る こ と が 予 想 さ れ る テ ス ト と は 、 別 カ ラ ム に 分 け て カ ウ ン ト さ れ ま す 。 た だ し 失 敗 す る こ と が 分 か っ て い る ("known") テ ス ト と 、 失 敗 が 予 想 さ れ る ("expected") テ ス ト は 、 ま と め ら れ ま す 。 テ ス ト が 警 告 や エ ラ ー を 生 成 し た 場 合 、 関 連 す る 行 の 終 わ り に ‘!W!’ や ‘!E!’ と い う タ グ が つ き ま す 。

オ プ シ ョ ン で な く 引 数 リ ス ト の 場 合 に は 、 ツ ー ル 名 ま た は フ ァ イ ル 名 が 含 ま れ る 場 合 が あ り ま す 。 コ マ ン ド は 、 DejaGnu 概 要 フ ァ イ ル (summary file) を 読 み 込 も う と し ま す 。 そ し て 、 そ の 場 合 に は 名 称 の 翻 訳 を 行 い ま す 。

*.sum

そ の ま ま 用 い ま す 。

*.log

同 じ ベ ー ス 名 を 用 い て *.sum に 書 き 換 え ま す 。

*.

概 要 フ ァ イ ル を 用 い る た め に 、 文 字 列 sum が 後 ろ に つ け ら れ ま す 。 こ の 処 理 は 、 シ ェ ル 上 の Readline に よ っ て 、 フ ァ イ ル 名 補 完 を 用 い た 場 合 の 利 便 性 の た め に 行 わ れ る も の で あ り 、 補 完 が ド ッ ト ま で 行 わ れ る か ら で す 。

*

ツ ー ル 名 と し て 扱 わ れ ま す 。 後 ろ に .sum が つ け ら れ ま す 。

オ プ シ ョ ン
-v , --verbose

の 操 作 自 体 を 説 明 す る 追 加 情 報 を 出 力 し ま す 。

フ ァ イ ル

コ マ ン ド が 出 力 を 生 成 す る 際 に は 、 DejaGnu に よ っ て 作 ら れ た 概 要 フ ァ イ ル を 読 み 込 ん で 、 "PASS" や "FAIL" な ど の 数 を カ ウ ン ト し ま す 。

引 数 に 名 前 が 指 定 さ れ な か っ た 場 合 、 カ レ ン ト デ ィ レ ク ト リ 内 の *.sum に 一 致 す る フ ァ イ ル す べ て が 読 み 込 ま れ ま す 。

例

DejaGnu 自 体 の テ ス ト ス イ ー ト か ら 、 単 純 な 例 を 示 し ま す 。

$ dejagnu report card
__________________________________________________
/ PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST
|--------------------------------------------------
launcher | 52 0 0 0 0 0 0
libdejagnu | 5 0 0 0 0 0 0
runtest | 135 0 0 0 0 0 0
|--------------------------------------------------
| 192 0 0 0 0 0 0
\__________________________________________________

3 つ の ツ ー ル が テ ス ト さ れ ま し た 。 そ こ で は 全 部 で 192 個 の テ ス ト が あ り 、 す べ て 成 功 す る こ と が 予 想 さ れ て い る も の で す 。 こ の 例 に お い て 、 テ ス ト は す べ て 成 功 (pass) し て い ま す 。 し た が っ て こ れ 以 外 の カ ラ ム は 、 す べ て ゼ ロ に な っ て い ま す 。 ‘?PASS’ と ‘?FAIL’ の カ ラ ム は 、 そ れ ぞ れ 失 敗 す る こ と が 分 か っ て い る (known) も の と 、 失 敗 が 予 想 さ れ る (expected) も の で あ っ た も の で 、 実 際 に は 、 予 想 に 反 し て 成 功 し た も の と 、 予 想 ど お り に 失 敗 し た も の を 、 そ れ ぞ れ 示 し て い ま す 。 残 り の 3 つ の カ ラ ム は 、 例 外 的 な 結 果 を 示 し て い る も の で 、 サ ポ ー ト さ れ て い な い (unsupported) テ ス ト 、 未 解 決 (unresolved) の テ ス ト 、 単 純 に テ ス ト し な い (untested) も の と し て 宣 言 さ れ て い る ス タ ブ テ ス ト を そ れ ぞ れ 示 し て い ま す 。

dejagnu-report-card に 対 す る テ ス ト が 追 加 さ れ た 後 の 同 様 の 結 果 例

$ dejagnu report-card
__________________________________________________
/ PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST
|--------------------------------------------------
launcher | 52 0 0 0 0 0 0
libdejagnu | 5 0 0 0 0 0 0
report-card / awk | 36 0 0 0 0 0 0
report-card / sh | 36 0 0 0 0 0 0
report-card / tcl | 36 0 0 0 0 0 0
runtest | 135 0 0 0 0 0 0
|--------------------------------------------------
awk | 36 0 0 0 0 0 0
sh | 36 0 0 0 0 0 0
tcl | 36 0 0 0 0 0 0
|--------------------------------------------------
| 300 0 0 0 0 0 0
\__________________________________________________

‘report-card’ ツ ー ル に 対 し て 、 各 実 装 ご と に 1 つ 、 合 計 で 3 つ の パ ス が 追 加 さ れ て い ま す 。 (こ の 後 に shell と Tcl に よ る 実 装 は 、 将 来 の メ ン テ ナ ン ス 負 荷 を 減 ら す た め に 、 取 り 除 か れ ま す 。 ) 前 の 例 と 同 じ く 、 テ ス ト は す べ て 期 待 ど お り に 成 功 し て い ま す 。 た だ 前 の 例 と 違 っ て 興 味 深 い の は 、 DejaGnu に よ る マ ル チ パ ス の テ ス ト 機 能 が 利 用 さ れ て い る 点 で す 。 こ れ に 従 っ て 、 パ ス ご と の 概 要 行 が 追 加 さ れ て い ま す 。 こ の 例 に お い て 、 マ ル チ パ ス の テ ス ト を 行 っ て い る の は ‘report-card’ ツ ー ル だ け で す 。 そ こ で 各 パ ス の 合 計 値 は 、 他 の 合 計 値 と は 違 っ て 、 単 に ‘report-card’ の テ ス ト 数 に す ぎ ま せ ん 。

ま た 、 の 実 行 に 用 い た コ マ ン ド が 、 こ こ で は 多 少 異 な っ て い る 点 を 確 認 し て く だ さ い 。 dejagnu (1) の 実 行 に あ た っ て は 、 複 数 単 語 を ダ ッ シ ュ 文 字 で つ な ぎ 合 わ せ て 1 つ の 引 数 と し て 受 け 渡 す こ と が で き ま す 。 こ う す る こ と に よ っ て 、 1 つ の コ マ ン ド 名 に 含 ま れ る 複 数 単 語 を 、 ダ ッ シ ュ や 空 白 に よ り 交 互 に 区 切 っ て 、 コ マ ン ド ラ イ ン 上 か ら 指 定 す る こ と が で き ま す 。

関 連 項 目

dejagnu (1) runtest (1)

DejaGnu の 完 全 な ド キ ュ メ ン ト は Texinfo マ ニ ュ ア ル と し て メ ン テ ナ ン ス さ れ て い ま す 。 info プ ロ グ ラ ム が 適 切 に イ ン ス ト ー ル さ れ て い れ ば 、 コ マ ン ド info dejagnu の 実 行 に よ っ て 、 完 全 な マ ニ ュ ア ル を 参 照 で き ま す 。

著 者

Jacob Bachmeyer GNU 2018/12/31 DEJAGNU-REPORT-CARD (1)