LCOV / GENHTMLコードカバレッジ出力にテストケースの説明を含める方法

Question

Cコードベースのコードカバレッジレポートを生成するためにLCOVを使用しています。テストの説明を最終的な出力に統合したい（LCOVのgendescユーティリティを使用して）

しかし、私はそれを行う方法についての手がかりがありません、そして、gendesc上の文書はかなりまばらとしているようです（古いグーグルが私に言うことができた限り。）

LTP のgendesc 入力テストの作成方法について説明します。ケース説明ファイル（GENHTMLによって期待されるように）。 > genhtml info は--show-descriptionsを提供し、そのようなテストケースの説明を入力するための--description-fileファイル。

しかし、最終報告書に含まれるようにテストケースを参照する方法はわかりません。 GENHTMLはそれらを未使用のテストケースとして見て、生成されたHTML出力からそれらを維持します。 --keep-descriptionsを使用できますが、それはどのテストケースが実行されたのかを教えてくれません（明らかにコードからテストの説明に参照する方法がわかりません）。

それで、最終出力で実行されたテストが実行されたLCOV / GENHTMLにどのように指示しますか？任意のアイデア？

Answer 1

テストケース名をカバレッジデータに関連付けるには、LCOVの--test-nameオプションを使用してカバレッジデータを収集しながらその名前を指定します。

lcov --capture --directory project-dir --output-file coverage.info --test-name "test01"

.

次に、すでに述べた手順、つまりテストケース記述ファイル "tests.txt"：

を作成します。

test01
    Some test

.

GENHTMLが予測した形式に変換する：

gendesc tests.txt --output-filename tests.desc

.

最後に説明ファイルをgenhtmlに指定します。

genhtml coverage.info --output-directory out --description-file tests.desc --show-details

.