vladiacob/sonar-swift

Open source Swift plugin for SonarQube (also supports Objective-C)

Branch	Status
master
develop

SonarQube Plugin for Swift

This is an open source initiative for Apple Swift language support in SonarQube. The structure of the plugin is based on the sonar-objective-c plugin.

In SonarQube under Quality Profiles the used Linter can be specified by selecting either the SwiftLint Profile or the Tailor Profile as Default profile for Swift Projects:

Features

Feature	Supported	MacOS	Unix
Complexity	YES	Uses Lizard	Uses Lizard
Design	NO
Documentation	YES
Duplications	Only on Sonarqube < 7.3
Issues	YES	Uses SwiftLint and/or Tailor for Swift. OCLint and Faux Pas for Objective-C	Uses Tailor
Size	YES
Tests	YES	Uses xcodebuild + xcpretty xcpretty	Not Supported
Code coverage	YES	Uses slather	Not Supported

Faux Pas support

Faux Pas is a wonderful tool to analyse iOS or Mac applications Objective-C source code, however it is not free. A 30 trial version is available here.

The plugin runs fine even if Faux Pas is not installed (Faux Pas analysis will be skipped).

Download

Checkout the Releases page.

The full release history is also available in CHANGELOG.md.

Launching an analysis

If you use fastlane, please read our fastlane integration doc. Otherwise, run the run-sonar-swift.sh script from your Xcode project root folder

Prerequisites

• a Mac with Xcode 7 or +
• SonarQube and SonarQube Scanner
• xcpretty (see instructions below)
• SwiftLint (HomeBrew installed and brew install swiftlint). Version 0.3.0 or above.
• Tailor (HomeBrew installed and brew install tailor). Version 0.11.1 or above.
• slather (gem install slather). Version 2.1.0 or above (2.4 since Xcode 8.3).
• lizard (PIP installed and sudo pip install lizard)
• OCLint installed. Version 0.11.0 recommended (0.13.0 since Xcode 9).
• Faux Pas command line tools installed (optional)

Installation of xcpretty with JUnit reports fix

At the time, xcpretty needs to be fixed to work with SonarQube.

To install the fixed version, follow those steps :

git clone https://github.com/Backelite/xcpretty.git
cd xcpretty
git checkout fix/duration_of_failed_tests_workaround
gem build xcpretty.gemspec
sudo gem install --both xcpretty-0.2.2.gem

Installation (once for all your Swift projects)

• Download the plugin binary into the $SONARQUBE_HOME/extensions/plugins directory
• Copy run-sonar-swift.sh somewhere in your PATH
• Restart the SonarQube server.

Configuration (once per project)

• Copy sonar-project.properties in your Xcode project root folder (along your .xcodeproj file)
• Edit the sonar-project.properties file to match your Xcode iOS/MacOS project

The good news is that you don't have to modify your Xcode project to enable SonarQube!. Ok, there might be one needed modification if you don't have a specific scheme for your test target, but that's all.

Update (once per plugin update)

• Install the lastest plugin version
• Copy run-sonar-swift.sh somewhere in your PATH

If you still have run-sonar-swift.sh file in each of your project (not recommended), you will need to update all those files.

Contributing

Thank you for your interest in the project! Contributions are welcome and appreciated.

Make sure to read these guides before getting started:

• Code of Conduct
• Contribution Guidelines

License

SonarQube Plugin for Swift is released under the GNU LGPL v3 license. See the LICENSE file for more info.