Add 'xml2lcov' utility - to convert XML coverage data - e.g.,

produced by Cobertura - to lcov format.

Signed-off-by: Henry Cox <[email protected]>

Author: henry2cox

Makefile

@@ -66,7 +66,7 @@ FILES   := README Makefile lcovrc \
 DIST_CONTENT := CONTRIBUTING COPYING README Makefile lcovrc \
 	bin example lib man rpm scripts tests
 
-EXES = lcov genhtml geninfo genpng gendesc perl2lcov py2lcov
+EXES = lcov genhtml geninfo genpng gendesc perl2lcov py2lcov xml2lcov xml2lcovutil.py
 # there may be both public and non-public user scripts - so lets not show
 #   any of their names
 SCRIPTS = $(shell ls scripts | grep -v -E '([\#\~]|\.orig|\.bak|\.BAK)' )

README

@@ -1,6 +1,6 @@
 -------------------------------------------------
 - README file for the LTP GCOV extension (LCOV) -
-- Last changes: 2023-02-22
+- Last changes: 2024-03-21
 -------------------------------------------------
 
 Description
@@ -60,6 +60,8 @@ Further README contents
   bin/gendesc        - Tool for creating description files as used by genhtml
   bin/perl2lcov      - Tool to translate Perl Devel::Cover data to lcov format
   bin/py2lcov        - Tool to translate Python Coverage.py to lcov format
+  bin/xml2lcov       - Tool to translate Cobertura-like XML coverage data
+                       to lcov format
   bin/geninfo        - Internal tool (creates LCOV data files)
   bin/genpng         - Internal tool (creates png overviews of source files)
   man                - Directory containing man pages for included tools
@@ -253,6 +255,15 @@ Point the web browser of your choice to the resulting index.html file.
      See 'perl2lcov --help' and the Devel::Cover documentation for more
      information.
 
+   iv) XML data (for example, generated by Cobertura):
+
+     - translate XM coverage data to LCOV format:
+
+         $ xml2lcov --output myData.info coverage.xml [xml2lcov options]
+
+     See 'xml2lcov --help' and the Cobertura documentation for more
+     information.
+
  b) Generate an HTML coverage report:
 
     Generate an HTML report, combining all of your LCOV data files:
@@ -413,7 +424,7 @@ New features and capabilities fall into 7 major categories:
 
   g) Language support
 
-     Added 'py2lcov' and 'perl2lcov' scripts.
+     Added 'py2lcov', 'perl2lcov' and 'xml2lcov' scripts.
 
        - py2lcov:
 
@@ -435,6 +446,16 @@ New features and capabilities fall into 7 major categories:
           Note that perl2lcov uses a similar set of command line and
           config file options as lcov, genhtml, and geninfo.
 
+       - xml2lcov
+
+          translates XML coverage data to lcov format.
+          The XML data may come from Cobertura or similar tools.
+
+          See "xml2lcov --help" fir brief instructions on how to use
+          the translator.
+          See the Coburtura documention for directions on how to
+          generate XML data.
+
      Other languages can be integrated using a similar approach.
 
 In general, the new features and options are implemented uniformly in lcov,