SonarQube is an open platform to manage code quality. This program can export code analysis from a SonarQube server as a docx file, xlsx file and text files.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
- Setup a SonarQube instance.
- Run an analysis with sonar-scanner, maven, gradle, msbuild, etc.
- Execute cnesreport thanks to the command line.
cnesreport does not need any installation. It is a portable Java application you can copy and run according to following examples. The only requirement is an up-to-date JRE (>1.8).
Use java -jar cnesreport.jar -h to get the following help about cnesreport:
usage: java -jar cnesreport.jar [-a <arg>] [-c] [-d <arg>] [-e] [-h] [-l <arg>] [-o <arg>] [-p <arg>] [-r <arg>]
[-s <arg>] [-t <arg>] [-v] [-w] [-x <arg>]
Generate editable reports for SonarQube projects.
-a,--author <arg> Name of the report writer.
-c,--disable-conf Disable export of quality configuration used during analysis.
-d,--date <arg> Date for the report. Default: current date.
-e,--disable-spreadsheet Disable spreadsheet generation.
-h,--help Display this message.
-l,--language <arg> Language of the report. Values: en_US, fr_FR. Default: en_US.
-o,--output <arg> Output path for exported resources.
-p,--project <arg> SonarQube key of the targeted project.
-r,--template-report <arg> Path to the report template. Default: usage of internal template.
-s,--server <arg> Complete URL of the targeted SonarQube server.
-t,--token <arg> SonarQube token of the SonarQube user who has permissions on the project.
-v,--version Display current version.
-w,--disable-report Disable report generation.
-x,--template-spreadsheet <arg> Path to the spreadsheet template. Default: usage of internal template.
Please report issues at https://github.com/lequal/sonar-cnes-report/issues
You can have more detailed logs in the hidden directory .cnesreport which should be created in your home directory at first launch.
This is the minimal usage of cnesreport. This example export (report + spreadsheet + configuration) the public project projectId from SonarQube server http://localhost:9000. This will use default internal templates.
java -jar cnesreport.jar -p projectId
If you are using a secured instance of SonarQube, you can provide a SonarQube authentication token thanks to -t option and specify the url of the SonarQube instance with -s. The internal template for the text report will be replace by the one given through -r option.
java -jar cnesreport.jar -t xuixg5hub345xbefu -s https://example.org:9000 -p projectId -r ./template.docx
As this application is used in many enterprise contexts, we have added the ability to go through proxy. The cnesreport application use system proxy configuration so that you have no fanciful parameter to set.
To use the proxy feature be sure to set following properties:
https.proxyHosthttps.proxyPorthttps.proxyUserhttps.proxyPassword
If your JRE's proxy is not set, you can use Java flags as follow:
java -Dhttps.proxyHost=https://myproxy -Dhttps.proxyPort=42
-Dhttps.proxyUser=jerry -Dhttps.proxyPassword=siegel
-jar cnesreport.jar -t xuixg5hub345xbefu -s https://example.org:9000 -p projectId
- Export code analysis as a set of files
- Export code analysis configuration
- Use custom templates
- Get a custom OpenXML (docx, xlsx) report
- Get a dynamic pivot table with all issues
- Export in french or english
| SonarQube / cnesreport | 1.1.0 | 1.2.0 | 1.2.1 | 2.0.0 |
| 3.7.x (LTS) | - | - | - | - |
| 4.5.x (LTS) | - | - | - | - |
| 5.6.x (LTS) | - | - | - | X |
| 6.0.x | - | - | - | X |
| 6.1.x | - | - | - | X |
| 6.2.x | - | - | - | X |
| 6.3.x | - | - | - | X |
| 6.4.x | - | - | - | X |
| 6.5.x | - | - | - | X |
| 6.6.x | - | - | - | X |
| 6.7.x (LTS) | X | X | X | X |
| 7.0 | - | - | - | X |
| 7.1 | - | - | - | X |
| 7.2 | - | - | - | X |
| 7.3 | - | - | - | X |
If you experienced a problem with the plugin please open an issue. Inside this issue please explain us how to reproduce this issue and paste the log.
If you want to do a PR, please put inside of it the reason of this pull request. If this pull request fix an issue please insert the number of the issue or explain inside of the PR how to reproduce this issue.
Copyright 2017 LEQUAL.
Licensed under the GNU General Public License, Version 3.0