You are viewing an old version of this page. View the current version.
Compare with Current ·
View Page History
 | Live example If you want to see a live example of the capabilities of the Python plugin, you can have a look at the analysis of the PyFFI project on Nemo. |
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
- Install the Python plugin through the Update Center or download it into the SONAR_HOME/extensions/plugins directory
- Restart the Sonar server
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:
- Python project analyzed with the Sonar Runner: /projects/languages/python/python-sonar-runner.
- Python project analyzed with Maven: /projects/languages/python/python-maven
Advanced settings to use pylint:
Property | Scope | Example | Description |
|---|---|---|---|
| sonar.python.pylint | System-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_config | Project-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.reportPath | Project-wide | nosetests.xml | Ant 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.reportPath | Project-wide | coverage.xml | Ant 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.itReportPath | Project-wide | it-coverage.xml | Ant 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.
Change Log
| Version 0.1 (5 issues) | |||||
|---|---|---|---|---|---|
| Type | Key | Summary | Priority | Status | Resolution |
|
SONARPLUGINS-1547 | Make the pylint integration configurable |
|
 Closed
|
Fixed |
|
SONARPLUGINS-1639 | Support of code duplication detection |
|
Closed
|
Fixed |
|
|
SONARPLUGINS-1635 | Rework the recognition of basic program entities |
|
Closed
|
Fixed |
|
|
SONARPLUGINS-1634 | Improve the pylint integration |
|
Closed
|
Fixed |
|
|
SONARPLUGINS-1573 | Add a colorizer for python code |
|
Closed
|
Fixed |
Labels
