sonar-icode-cnes-plugin

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #android #rust #docker #macos #nodejs #java #awesome #kubernetes #mcp

sonar-icode-cnes-plugin

(★ 21)

Add capability to analyze Fortran in SonarQube through i-Code CNES.

sonar-icode-cnes-plugin Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# sonar-icode-cnes-plugin
[![Build Status](https://travis-ci.org/lequal/sonar-icode-cnes-plugin.svg?branch=master)](https://travis-ci.org/lequal/sonar-icode-cnes-plugin)
[![SonarQube Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=alert_status)](https://sonarcloud.io/dashboard?id=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin)
[![SonarQube Bugs](https://sonarcloud.io/api/project_badges/measure?project=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=bugs)](https://sonarcloud.io/project/issues?id=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&resolved=false&types=BUG)
[![SonarQube Coverage](https://sonarcloud.io/api/project_badges/measure?project=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=coverage)](https://sonarcloud.io/component_measures?id=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=Coverage)
[![SonarQube Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=sqale_index)](https://sonarcloud.io/component_measures?id=fr.cnes.sonar.plugins%3Asonar-icode-cnes-plugin&metric=sqale_index)

SonarQube plugin for the code analysis tool: i-Code CNES.

SonarQube is an open platform to manage code quality. This plugin adds the ability to check Fortran (77 & 90) with i-Code or import pre-existing results of i-Code.

This plugin 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.

You can get i-Code CNES on GitHub: [cnescatlab/i-CodeCNES](https://github.com/cnescatlab/i-CodeCNES).

### Quickstart
- Setup a SonarQube instance.
- **[Optional]** Install i-Code command line application as described in [official documentation](https://github.com/cnescatlab/i-CodeCNES/wiki/Installation-Manual).
- Install `sonaricode-*.jar` in `<SONARQUBE_HOME>/extensions/plugins/`.
- **[Optional]** Run i-Code manually or configure auto-launch in plugin configuration.
- Run an analysis with *sonar-scanner*, *maven*, *gradle*, *msbuild*, etc.

#### Run i-Code automatically
This SonarQube plugin is now able to run automatically an embedded version of i-Code. If you do not specify properties to run i-Code [manually](#run-i-Code-manually) or [from a specific version](#Run-a-specific-i-Code-version-through-sonaricode-plugin), embedded version of i-Code will be executed.

Here is the compatibility matrix of the plugin:

| sonaricode version | embedded i-Code version | supported SonarQube version | supported languages |
|:------------------:|:-----------------------:|:---------------------------:|:--------------------|
|       < 2.0.0      |           none          |          6.7.x              |   Fortran / Shell   |
|        2.0.0       |          4.0.0          |        7.9 -> 8.2           |   Fortran / Shell   |
|        2.0.1       |          4.0.0          |        7.9 -> 8.2           |   Fortran / Shell   |
|        2.0.2       |          4.1.0          |        7.9 -> 8.2           |   Fortran / Shell   |
|        2.0.3       |          4.1.2          |        7.9 -> 8.2           |   Fortran / Shell   |
|        3.0.0       |          4.1.0          |        7.9 -> 8.2           |       Fortran       |
|        3.0.1       |          4.1.2          |        7.9 -> 8.2           |       Fortran       |
|        3.1.0       |          4.1.2          |        7.9 -> 9.9           |       Fortran       |
|        3.1.1       |          4.1.2          |        7.9 -> 9.9           |       Fortran       |
|        3.1.2       |          5.1.0          |        7.9 -> 9.9           |       Fortran       |
|        5.1.0       |          5.1.0          |        7.9 -> 9.9           |       Fortran       |
|        5.2.0       |          5.1.0          |      25.1.0 -> 25.9.0       |       Fortran       |

*Notice: Since 5.X this plugins will follow I-Code versionning. There is no breaking changes between 3.X and 5.X*

#### Run i-Code manually
If you need help to run i-Code please refer to the [official user manual](https://github.com/cnescatlab/i-CodeCNES/wiki/User-Manual) or [i-Code issue tracker](https://github.com/cnescatlab/i-CodeCNES/issues).

#### Run a specific i-Code version through sonaricode plugin
If embedded version of i-Code does not match your need, you can set the execution of another installed version of i-Code through the following properties:
- `sonar.icode.launch`: Activate autolaunch for i-Code if `true`. Default: `false`.
- `sonar.icode.path`: Define i-Code CNES executable path to auto-launch it on analysis. Default: `${HOME}/icode-cnes/icode.exe`.

#### Other plugin's properties
- `sonar.f77.file.suffixes`: List of suffixes for F77 files to analyze. Default: `.f,.f77,.for,.fpp,.ftn,.F,.F77,.FOR,.FPP,.FTN`.
- `sonar.f90.file.suffixes`: List of suffixes for F90 files to analyze. Default: `.f90,.F90`.
- `sonar.icode.reports.path`: Path to the i-Code reports. Multiple path can be provided. Default: `result.res`.

### Features
- Fortran 77 analysis
- Fortran 90 analysis
- Import i-Code results

#### Get i-Code help
Use `icode -h` to get the following help about i-Code:
````
usage: icode [<FILE> [...]] [-c <arg>] [-e] [-f <arg>] [-h] [-l] [-o <arg>] [-p <arg>] [-q <arg>] [-r] [-x <arg>]
Analyze F77 & F90 code to find defects & bugs.

-c,--checked-languages <arg>        Comma separated list of languages checked during analysis. All by default.
 -e,--exporters                      Display all available exporters.
 -f,--export-format <arg>            Set the format for result file. Default format is XML.
 -h,--help                           Display this message.
 -l,--languages                      Display all available languages.
 -o,--output <arg>                   Set the name for result file. Results are displayed in standard output by default.
 -p,--export-parameters <arg>        Comma separated list of parameters for the export. Format is:
                                     key1=value1,key2=value2,key3=value3. Default values depend on the chosen export plugin.
 -q,--list-export-parameters <arg>   Display all available parameters for the given export.
 -r,--rules                          Display all available rules.
 -x,--excluded-rules <arg>           Comma separated list of rules id to exclude from analysis. None by default.

Please report issues at https://github.com/leqcnescatlabual/i-CodeCNES/issues
````

### How to contribute
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.

All details are available in [CONTRIBUTING](https://github.com/cnescatlab/sonar-icode-cnes-plugin/blob/master/CONTRIBUTING.md).

### Feedback and Support
Bugs and Feature requests: https://github.com/cnescatlab/sonar-icode-cnes-plugin/issues

### License
Licensed under the [GNU General Public License, Version 3.0](https://www.gnu.org/licenses/gpl.txt)

sonar-icode-cnes-plugin

sonar-icode-cnes-plugin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

sonar-icode-cnes-plugin

sonar-icode-cnes-plugin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README