SonarLint is a free IDE extension that lets you fix coding issues before they exist!
Like a spell checker, SonarLint highlights Bugs and Security Vulnerabilities as you write code, with clear remediation guidance so you can fix them before the code is even committed.
SonarLint in Emacs supports analysis of JavaScript, TypeScript, Python, Java, HTML , PHP, Ruby, Scala and XML out of the box!
The SonarLint language server needs a Java Runtime (JRE) 8 or 11. If one is already installed on your computer, SonarLint should automatically find and use it.
To analyze JavaScript and TypeScript, SonarLint will also need Node.js.
Download and include the main file lsp-sonarlint.el and the folders languages and server.
You can then run the following commands to install lsp-sonarlint:
M-x package-refresh-contents RET (to refresh your package database)
M-x package-install RET lsp-sonarlint RET (to install and compile `lsp-sonarlint` and its dependencies)
Sonarlint language server relies on java plugins to properly analyze the selected language source code. The basic workflow to activate a plugin for a language is:
- Enable language specific extension, alongside lsp-sonarlint:
(require 'lsp-sonarlint)
(require 'lsp-sonarlint-LANGUAGENAME)- It is important to enable the desired languages before execute the lsp client:
(setq lsp-sonarlint-LANGUAGENAME-enabled t)-
If the extension is not installed in the path lsp-sonarlint-LANGUAGENAME-analyzer-path, it will ask if you want to download it from the URL defined in lsp-sonarlint-LANGUAGENAME-download-url.
-
If everything went well, you can now activate the lsp emacs command.
In this example, we have a multiple language project, with javascript,HTML and PHP:
(require 'lsp-sonarlint)
(require 'lsp-sonarlint-php)
(setq lsp-sonarlint-php-enabled t)
(require 'lsp-sonarlint-html)
(setq lsp-sonarlint-html-enabled t)
(require 'lsp-sonarlint-javascript)
(setq lsp-sonarlint-javascript-enabled t)
Now we can active the lsp extension.
The extension will check every plugin path and ask if it is not find to download it, the default path is defined in lsp-sonarlint-LANGUAGENAME-analyzer-path.
Out of the box, SonarLint automatically checks your code against the following rules:
- JavaScript rules
- TypeScript rules
- Python rules
- Java rules
- HTML rules
- PHP rules
- Scala rules
- Ruby rules
- XML rules
lsp-sonarlint-server-path- Path of the sonarlint jar executable file.lsp-sonarlint-modes-enabled- List of major modes where the lsp server will activate.lsp-sonarlint-disable-telemetry- Disable telemetry option (disabled by default).lsp-sonarlint-test-file-pattern- Regex to find test file, most rules are not evaluated on test files.lsp-sonarlint-show-analyzer-logs- Show analyzer logs.lsp-sonarlint-server-download-url- Sonarlint server download URL.
This settigns are common for all the language plugins.
lsp-sonarlint-LANGUAGE-enabled- Enable LANGUAGE lsp-sonarlint plugin (disable by default)lsp-sonarlint-LANGUAGE-download-url- URL to download the LANGUAGE sonarlint pluginlsp-sonarlint-LANGUAGE-analyzer-path- Location where the plugin/anlyzer is located.lsp-sonarlint-LANGUAGE-doc-url- Sonarsource official plugin documentationlsp-sonarlint-LANGUAGE-repository-url- Plugin source code
This extension collects anonymous usage data and sends it to SonarSource.
Collection of telemetry is controlled via the setting: lsp-sonarlint-disable-telemetry, it is disable by default.
Click here to see a sample of the data that are collected.
- lsp-ui : Flycheck, documentation and code actions support.
- company-capf : Completion backend support.
- treemacs : Project viewer.
- lsp-treemacs :
lsp-modeGUI controls implemented using treemacs.
Contributions are very much welcome.