Skip to content

mbyrnepr2/sonar-python

 
 

Repository files navigation

Code Quality and Security for Python Build Status Quality Gate

Python analyzer for SonarQube, SonarCloud and SonarLint

Useful links

Building the project

Fast/minimal build

Prerequisites:

  • JDK 11
  • Maven 3.0.0 or newer

The easiest way to build the Project is by running:

mvn clean install -DskipTypeshed

It builds only Java Maven modules, run tests, and install jar locally. The Python interpreter is not required in that case.

Full build

Prerequisites:

  • JDK 11
  • Maven 3.0.0 or newer
  • Python 3.9 or newer
  • tox - pip install tox
  • Run git submodule update --init to retrieve Typeshed as a Git submodule

All above should be available in PATH.

To execute full build just run:

mvn clean install

The full build executes Typeshed serializer script. It generates protobuf messages for Typeshed symbols (for standard Python API) and our customs symbols (for Python libraries, e.g. AWS CDK). This helps in type inference and providing better rules.

How to contribute

Configuration

First, please configure your IDE: https://github.com/SonarSource/sonar-developer-toolset.

Rule annotation

Each new implemented rule should have @Rule(key = "S0000") annotation on the class level. The number of the rule can be found here: https://sonarsource.github.io/rspec/#/rspec/?lang=python. The key is usually automatically generated by a rspec repository GitHub action and needs to be unique in the whole project.

Expectations:

  • Commit message should be prefixed with the ticket number.
  • Working on separate branch and creating PR when it's finished.
  • Clean coded, well tested solution, quality gate should pass.
  • Fix all issues reported by SonarQube Next instance.
  • 95% or more code coverage for new changes (if possible). It can be checked on CI build.

Before push

Please check if all files have a license header. If not, the mvn install will fail with Some files do not have the expected license header message. To fix that please execute: mvn license:format.

License

Copyright 2011-2022 SonarSource.

Licensed under the GNU Lesser General Public License, Version 3.0

Releases

No releases published

Packages

No packages published

Languages

  • Java 55.2%
  • Python 39.0%
  • HTML 5.8%
  • Jupyter Notebook 0.0%
  • Dockerfile 0.0%
  • Makefile 0.0%