cppcheck-codequality 1.1.1

Convert a CppCheck XML report to a GitLab-compatible Code Quality JSON report

cppcheck-codequality

       

About

I wanted reports from CppCheck to appear in GitLab Merge Requests as Code Quality reports, which is a JSON file defined by the Code Climate team/service.

That's all this does: convert CppCheck XML to Code Climate JSON.

Usage

Install with PIP (note the underscore here):

python3 -m pip install -U cppcheck_codequality

It is primarily used as a console script. As such, ensure you have Python 3's "scripts" directory in your PATH variable. For example, on Linux, that might be $HOME/.local/bin.

To test, try the --help or --version flags (note the dash here, instead of underscore):

cppcheck-codequality --help

CppCheck already has a script to convert its XML report to HTML for easy human reading. See "Chapter 11 HTML Report" in the CppCheck Manual

This script follows that example and provides similar command-line options. So usage is as follows:

# Generate CppCheck report as XML
cppcheck --xml --enable=warning,style,performance ./my_src_dir/ 2> cppcheck_out.xml
# Convert to a Code Climate JSON report
cppcheck-codequality --input-file=cppcheck_out.xml --output-file=cppcheck.json

OR, you could invoke the script directly, as a module, like this:

# Run as a module instead
python3 -m cppcheck_codequality.__main__ --input-file=cppcheck_out.xml --output-file=cppcheck.json

Now, in your GitLab CI script, upload this file as a Code Quality report.

my-code-quality:
  script:
    - [...]
  artifacts:
    reports:
      codequality: cppcheck.json

Contributing

• Sign the contributor agreement (coming soon)
• Format with black
• Check with pylint

Credits & Trademarks

CppCheck is an open-source project with a GPL v3.0 license.

• http://cppcheck.sourceforge.net
• https://github.com/danmar/cppcheck

"Code Climate" may be a registered trademark of Code Climate, Inc. which provides super-cool free and paid services to the developer community.

• https://codeclimate.com
• https://github.com/codeclimate

"GitLab" is a trademark of GitLab B.V.

• https://gitlab.com
• https://docs.gitlab.com/ee/user/project/merge_requests/code_quality.html

All other trademarks belong to their respective owners.