Skip to content

integrated-application-development/delphilint

Repository files navigation

DelphiLint

Build Format

DelphiLint is an IDE package for RAD Studio that provides on-the-fly code analysis and linting, powered by SonarDelphi.

Features

  • Brings SonarDelphi, a static analyzer for Delphi with 100+ code analysis rules, to the Delphi IDE
  • Analyze one or more files on-the-fly, shortening the feedback loop so you can pick up and fix problems before they're even checked in
  • Detected issues, along with descriptions and rationale, displayed inline in the IDE
  • Two analysis modes:
    • Standalone - run analyses entirely locally with a default set of active rules
    • Connected - connect to a SonarQube instance, allowing for
      • Fetching of active rules and configuration from the server's configured quality profiles
      • Suppression of issues that have been resolved in past analyses
      • Usage of the server's version of SonarDelphi
  • Support for reading standard sonar-project.properties files, providing additional configuration
  • A Visual Studio Code companion extension that can be used to run analyses and show results in VS Code itself

Installation

System requirements:

Installation steps:

  1. Download the packaged zip for your Delphi version from the latest release, or build from source.
  2. Unzip the folder and run the included install.bat script.
  3. Done!

Warning

Unfortunately, Delphi Community Edition is not supported.

See the FAQ for more information.

Installing the VS Code companion

  1. Download the .vsix extension file from the latest release, or build from source.
  2. Run code --install-extension <vsix> to install the extension.

Important

For the companion to work, a DelphiLint installation of the same version must be installed.

The VS Code companion is not required for the Delphi IDE plugin to function.

Usage

To analyze a file:

  1. Open a Delphi project in the IDE.
  2. Open the Delphi source file you want to analyze.
  3. Click the DelphiLint > Analyze This File menu option.

It's as easy as that! The DelphiLint window will then pop up, showing the current state of analysis and any issues that are raised. Please note that when the file has a lot of imports the analysis could take thirty seconds or so.

To analyze all files that are open in the IDE, use DelphiLint > Analyze All Open Files instead.

For more information:

  • See Configuration for details on project configuration settings.
  • See the FAQ for answers to common questions and problems.

Gallery

Building from source

Prerequisites:

To build DelphiLint, use scripts/build.ps1:

  • scripts/build.ps1 280 to build for Delphi 11 Alexandria
  • scripts/build.ps1 290 to build for Delphi 12 Athens

This creates a target/DelphiLint-<version>- folder containing all built artifacts.

Note

build.ps1 looks for a Delphi installation in the default location for the given version. If your installation is elsewhere, supply the location as part of the version parameter, e.g. scripts/build.ps1 280=/my/custom/location.

Contributing

DelphiLint is open for contributions - please read the contributing guide for more information.

License

Licensed under the GNU Lesser General Public License, Version 3.0.

About

Delphi IDE package providing on-the-fly code analysis and linting, powered by SonarDelphi

Resources

License

Stars

Watchers

Forks

Packages

No packages published