Cómo incluir descripciones de la caja de prueba en la salida de cobertura de código LCOV / GENHTML

Question

Estoy usando LCOV para generar informes de cobertura de código para una base de código C. Me gustaría integrar las descripciones de las pruebas en la salida final (utilizando la utilidad GENDESC de LCOV).

Sin embargo, no tengo ni idea de cómo hacerlo, y la documentación sobre GENDESEC parece bastante escasa (en la medida en que el google de buen viejo ha podido decirme).

The Información de GENDESC en LTP describe cómo crear la prueba de entrada CASO DESCRIPCIÓN ARCHIVOS (como se espera por GENHTML). Y el genhtml info proporciona --show-descriptions, y --description-file para ingresar dicho caso de prueba Descripción archivos.

Sin embargo, no sé cómo hacer referencia a los casos de prueba para que se incluyan en el informe final. GenHTML los ve como Los casos de prueba no utilizados y así los mantienen fuera de la salida HTML generada. Puedo usar --keep-descriptions, pero eso no me dice qué casos de prueba se ejecutaron (obviamente porque no sé cómo hacer la referencia del código para probar la descripción.)

Entonces, ¿cómo le decimos a LCOV / GENHTML qué pruebas se ejecutaron en la salida final? ¿Alguna idea?

Answer 1

Para asociar un nombre de la caja de prueba con los datos de cobertura, especifique ese nombre al recopilar datos de cobertura utilizando la opción de Nombre de LCOV:

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

Luego continúe con los pasos que ya mencionó, que es crear un archivo de prueba de prueba "TESTS.TXT":

test01
    Some test

Convierte en el formato esperado por GenHTML:

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

Finalmente especifique los archivos de descripciones a GENHTML:

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