So fügen Sie Testfallbeschreibungen in die Ausgabe der lcov/genhtml-Codeabdeckung ein

Question

Ich verwende lcov, um Codeabdeckungsberichte für eine C-Codebasis zu generieren.Ich möchte Testbeschreibungen in die endgültige Ausgabe integrieren (mithilfe des Gendesc-Dienstprogramms von lcov).

Allerdings habe ich keine Ahnung, wie das geht, und die Dokumentation zu gendesc scheint eher spärlich zu sein (soweit mir das gute alte Google sagen konnte).

Der Gendesc-Infos bei LTP beschreibt, wie die Eingabetestfallbeschreibungsdateien erstellt werden (wie von genhtml erwartet).Und das Genhtml-Info bietet --show-descriptions, Und --description-file zur Eingabe solcher Testfallbeschreibungsdateien.

Allerdings weiß ich nicht, wie ich die Testfälle referenzieren soll, damit sie in den Abschlussbericht aufgenommen werden.genhtml sieht sie als ungenutzte Testfälle und hält sie somit aus der generierten HTML-Ausgabe fern.ich kann nutzen --keep-descriptions, aber das sagt mir nicht, welche Testfälle ausgeführt wurden (offensichtlich, weil ich nicht weiß, wie ich den Verweis vom Code auf die Testbeschreibung herstellen soll).

Wie teilen wir lcov/genhtml also mit, welche Tests in der endgültigen Ausgabe ausgeführt wurden?Irgendwelche Ideen?

Answer 1

Um einen Testfallnamen mit Abdeckungsdaten zu verknüpfen, geben Sie diesen Namen beim Sammeln von Abdeckungsdaten mit der Option --test-name von lcov an:

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

Fahren Sie dann mit den bereits erwähnten Schritten fort, d. h. erstellen Sie eine Testfallbeschreibungsdatei „tests.txt“:

test01
    Some test

Konvertieren Sie es in das von genhtml erwartete Format:

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

Geben Sie abschließend die Beschreibungsdatei für genhtml an:

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