Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 59 Next »

Table of Contents

Description / Features

This plugin enables the analysis of Python projects.

Dependencies

This plugin has the following dependencies:

  • Pylint must be installed to check Pylint coding rules.

Installation

  1. Install the Python plugin through the Update Center
  2. Restart Sonar

Usage

You can analyze your project with the different analyzers. Here are properties files examples for the Sonar Runner and Maven.

A list of sample projects is available on github that can be browsed or downloaded:

  1. Python project analyzed with the Sonar Runner: /projects/languages/python/python-sonar-runner.
  2. Python project analyzed with Maven: /projects/languages/python/python-maven

Advanced settings to use pylint:

Property

Scope

Example

Description

sonar.python.pylintSystem-wide/usr/local/bin/pylint

Path to the pylint executable to use in pylint analysis. Set to empty to use the default one.

It has to be set on Windows, use either masked backslashes or slashes as path separators; examples: C:\\Python26\\Scripts\\pylint.bat or C:/Python/26/Scripts/pylint.bat

sonar.python.pylint_configProject-wide.pylintrc

Path to the pylint configuration file (relative to project root or absolute) to use in pylint analysis. Set to empty to use the default.

sonar.python.xunit.reportPathProject-widenosetests.xmlAnt pattern describing the path to unit test execution reports, relative to projects root. Leave unset to use the default ("xunit-reports/xunit-result-*.xml"). The reports have to conform to the junitreport XML format.
sonar.python.coverage.reportPathProject-widecoverage.xmlAnt pattern describing the path to coverage reports, relative to projects root. Leave unset to use the default ("coverage-reports/coverage-*.xml"). The reports have to conform to the Cobertura XML format.
sonar.python.coverage.itReportPathProject-wideit-coverage.xmlAnt pattern describing the path to coverage reports for integration tests, relative to projects root. Leave unset to use the default ("coverage-reports/it-coverage-*.xml"). The reports have to conform to the Cobertura XML format.

Make sure to set up the environment properly (PYTHONPATH etc.) before running the analyzer, if your project requires it.

External report generation

Here is a quick guide how to generate the reports using external tools.

Test execution

nosetests --with-xunit [tests to execute]

To get a more accurate execution time statistics make sure to use nose 1.1.0 or newer.

Coverage

Use Ned Batchelders coverage package like this:

coverage erase
coverage run --branch --sources=<python packages> <program> 
coverage xml -i

Make sure to put all packages to measure into the --source parameter. That ensures that coverage will report zero coverage on all untouched files, as you most probably want to. To make this work, make sure to meet two prerequisites:

  • use coverage => 3.4
  • the packages should be packages, i.e. every directory on the way to the sources should contain an __init__.py file.


Extending Coding Rules using XPath

New coding rules can be added using XPath. See the related documentation.

To navigate the AST, download the SSLR Python Toolkit.

Changelog

Loading

Version 1.1 (12 issues)

Loading

Version 1.0 (26 issues)

T Key Summary P Status Resolution
Bug SONARPLUGINS-1721 pygenie stops the code analyse if it tries to analyse a file not ending with a empty row Critical Closed Fixed
Bug SONARPLUGINS-1722 Absolut paths in sonar.python.pylint_config are prefixed with the path of the project Major Closed Fixed
New Feature SONARPLUGINS-2032 Rule: Always use upper case "L" for long integers Major Closed Fixed
New Feature SONARPLUGINS-2031 Rule: Regular expression on comment Major Closed Fixed
New Feature SONARPLUGINS-2030 Rule: Avoid deeply nested if statements Major Closed Fixed
New Feature SONARPLUGINS-2024 Rule: Avoid usage of <> operator Major Closed Fixed
New Feature SONARPLUGINS-2028 Rule: Avoid too complex function Major Closed Fixed
New Feature SONARPLUGINS-2022 Rule: Avoid usage of exec statement Major Closed Fixed
New Feature SONARPLUGINS-2021 Rule: When there is a parsing error, this error should be added like a violation on that Python file Major Closed Fixed
New Feature SONARPLUGINS-2023 Rule: Avoid usage of `` (backtick) operator Major Closed Fixed
New Feature SONARPLUGINS-2026 Rule: One statement per line Major Closed Fixed
Bug SONARPLUGINS-2018 Python Plugin not compatible with SCM Activity Plugin Major Closed Fixed
Improvement SONARPLUGINS-2020 Replace ANTLR-based lexer by our own Major Closed Fixed
Improvement SONARPLUGINS-2019 Rename default quality profile to "Sonar way" to be consistent with other plugins Major Closed Fixed
New Feature SONARPLUGINS-2016 Metric: blank comments Major Closed Fixed
New Feature SONARPLUGINS-2015 Metric: functions Major Closed Fixed
New Feature SONARPLUGINS-2014 Rule: Generic Python rule to define some homemade checks with an XPath expression Major Closed Fixed
New Feature SONARPLUGINS-2013 Metric: statements Major Closed Fixed
New Feature SONARPLUGINS-2012 Provide Python rule engine based on SSLR Major Closed Fixed
New Feature SONARPLUGINS-2006 Provide a default SQALE mapping for the Python rules Major Closed Fixed
Showing 20 out of 26 issues Refresh

Loading

Version 0.1 (5 issues)

 

  • No labels