##Description / Features The plugin enables analysis of Ruby projects within SonarQube (most recently tested against version 4.5.5 LTS)
Currently the plugin captures basic metrics (Lines of Code, Number of classes and packages, Comment percentage), complexity on each file, and a visual line-by-line code coverage report.
It relies on well-known external tools: SimpleCov, SimpleCov-RCov and Metric_Fu
##Install Download the plugin into the SONARQUBE_HOME/extensions/plugins directory
##Usage
Make sure the property sonar.language is set to ruby: sonar.language=ruby in the sonar-project.properties file
#####Code Coverage
In order for the plugin to report on code coverage, the ruby project needs to be using simplecov-rcov
to generate a coverage report when you run your tests/specs, please see the gem's homepage here for installation
and usage instructions.
Important: Do not change the output directory for the simplecov-rcov report, leave it as default, or code coverage will not be reported.
#####Code Complexity
In order for the plugin to report on code complexity, metric_fu needs to be ran against the ruby project,
which will generate a metric report. Please see the gem's homepage here for installation and usage instructions.
Important: metric_fu reports on more than just code complexity, however we still recommend to use the metric_fu command: metric_fu -r
this will run all metrics. At the very least, Saikuro/Cane and Hotspots metrics need to be ran for complexity to be reported.
##Future Plans
- Code Duplication
- Code Violations
##Giving Credit The github project pica/ruby-sonar-plugin, is where the ruby-sonar-plugin started, rather than reinvent the wheel, we thought it better to enhance it. We used that plugin as a starting point for basic stats, then, updated the references to their latest versions and added additional metrics like line-by-line code coverage and code complexity.
We referenced the javascript sonar plugin and the php sonar plugin for complexity and coverage implementation. Our complexity sensor and code coverage sensor borrow heavily from the javascript plugin's equivalent sensors.
##Tool Versions This plugin has been tested with the following dependency versions
- SonarQube 4.5.5 LTS
- SonarQube Runner 2.3 (or newer)
- metric_fu gem version 4.12.0 (latest at time of edit)
- simplecov 0.8.2
- simplecov-rcov 0.2.3