Skip to content

Latest commit

 

History

History
127 lines (92 loc) · 7.73 KB

README.md

File metadata and controls

127 lines (92 loc) · 7.73 KB

SonarDelphi

quality gate format build

SonarDelphi is a modern, performant, and fully-featured community code analyzer for the Delphi language. As a plugin for the SonarQube code analysis platform, it can be easily integrated into existing workflows.

This project has three primary goals:

  • Correctness: All valid Delphi code should be accepted and understood correctly.
  • Utility: Analysis results should be easily understandable and immediately actionable.
  • Extensibility: New rules should be trivial to add and have access to the full power of the analyzer.

This project aims to follow the conventions and best practices of SonarQube's official analyzers. It is actively maintained by a core team and is open for community contributions.

Features

With SonarDelphi, you can:

  • Analyze Delphi code, identifying issues from more than 120 rules
  • Create custom rules in the SonarQube UI from templates
  • Import NUnit test reports (compatible with DUnitX)
  • Import test coverage reports (compatible with DelphiCodeCoverage)

Semantic analysis

SonarDelphi understands what your code means, paving the way for powerful rules such as:

Dead code analysis

Using semantic analysis, SonarDelphi can identify unused code in your project, including:

Advanced custom rules

In addition to template rules, SonarDelphi can be extended with custom rules plugins:

Quickstart

  1. Install the following:

  2. Install the plugin:

  3. Run analysis on your Delphi project:

    • Configure your Sonar project, including sonar.delphi.installationPath.
    • Execute sonar-scanner in your project's directory.
  4. View analysis results:

    • Visit the link provided at the end of the scan to view analysis results on SonarQube.

Read the Manual

The SonarDelphi Manual provides a comprehensive guide to SonarDelphi and the Sonar ecosystem, including:

  • An introduction to SonarQube
  • How to configure SonarDelphi projects and scans
  • How to customize analysis rules

Tip

It is strongly recommended that first-time SonarQube users read the "SonarQube from first principles" section of the manual.

Contributing

SonarDelphi is open for contributions, from bug reports to new features. For more details, please read the contributing guide.

Development

SonarDelphi can be built with JDK 11+ using Maven.

To build the project and run unit tests, execute the following command from the project's root directory:

mvn clean install

After building, the plugin jar can be found in sonar-delphi-plugin/target.

History

In 2012, Sabre Airline Solutions released SonarDelphi as an open source project. Over the years, it has been forked and iterated on by various maintainers.

In 2018, it was picked up as a Monash University student project for IntegraDev. Since 2019, the project has been actively developed and extensively rewritten by IntegraDev.

License

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