Provided by: manpages-ja_0.5.0.0.20221215+dfsg-1_all 
名前
dejagnu report card — 複数ツールに対するテスト結果の取りまとめ
書式
dejagnu report card [⟨option⟩ | ⟨tool⟩ | ⟨file⟩] ...
説明
The dejagnu report card コマンドは、 複数ツールによるテスト結果を表形式で表示します。 生成さ
れるこの表においては、 以下の項目を一覧表示します。 各ツールごとに (そして複数パスが実行され
た場合には、 各パスごとに)、 テストの成功数 (passed)、 失敗数 (failed)、 未対応数
(unsupported)、 未解決数 (unresolved)、 未実施数 (untested) です。 失敗することが予想される
テストは、 成功することが予想されるテストとは、 別カラムに分けてカウントされます。 ただし失
敗することが分かっている ("known") テストと、 失敗が予想される ("expected") テストは、 まと
められます。 テストが警告やエラーを生成した場合、 関連する行の終わりに ‘!W!’ や ‘!E!’ という
タグがつきます。
オプションでなく引数リストの場合には、 ツール名またはファイル名が含まれる場合があります。
dejagnu report card コマンドは、 DejaGnu 概要ファイル (summary file) を読み込もうとします。
そして、 その場合には名称の翻訳を行います。
*.sum そのまま用います。
*.log 同じベース名を用いて *.sum に書き換えます。
*. 概要ファイルを用いるために、 文字列 sum が後ろにつけられます。 この処理は、 シェル上
の Readline によって、 ファイル名補完を用いた場合の利便性のために行われるものであり、
補完がドットまで行われるからです。
* ツール名として扱われます。 後ろに .sum がつけられます。
オプション
-v, --verbose dejagnu report card の操作自体を説明する追加情報を出力します。
ファイル
dejagnu report card コマンドが出力を生成する際には、 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 report card の実行に用いたコマンドが、 ここでは多少異なっている点を確認してく
ださい。 dejagnu(1) の実行にあたっては、 複数単語をダッシュ文字でつなぎ合わせて 1 つの引数と
して受け渡すことができます。 こうすることによって、 1 つのコマンド名に含まれる複数単語を、
ダッシュや空白により交互に区切って、 コマンドライン上から指定することができます。
関連項目
dejagnu(1) runtest(1)
DejaGnu の完全なドキュメントは Texinfo マニュアルとしてメンテナンスされています。 info プロ
グラムが適切にインストールされていれば、 コマンド info dejagnu の実行によって、 完全なマニュ
アルを参照できます。
著者
Jacob Bachmeyer