# Utiliser Jenkins pour tester du code python

> Testé avec Python 3.4

## Pré-requis:

Installer les librairies suivantes sur la machine de test:

* nose2 > `pip install nose2`
* cov-core > `pip install cov-core`
* junit-xml > `pip install junit-xml`
* pylint > `pip install pylint`
> si ImportError au lancement de pylint, executer aussi:
> `pip install wrapt lazy_object_proxy --upgrade`

### Configurer jenkins

Installer les plugins:  

* Cobertura
* Git Plugin
* Violations
* PostBuildScript

Cliquer sur `Télécharger et redémarrer ensuite`

Dans `Configurer Jenkins`>`Configurer le système`

* Git Plugin: renseigner user.name et user.email
* Shell: `C:\Windows\system32\cmd.exe`


### Créer le Job

Cliquer sur `New Job` > `Freestyle project` > `OK`

Sur la page de configuration du Job, choisir Git comme SCM, avec le chemin du repo local comme repository path

`Add Build Step` > `Execute windows batch command`

Ajouter au champs Command:
	
	set PYTHONPATH=''
	nose2 --plugin nose2.plugins.junitxml --junit-xml --with-coverage
	python -m coverage xml --include=.\*
	pylint -f parseable [nom_du_module]  > pylint.log
	exit 0

> attention au module donné en paramètre à pylint: celui-ci doit comprendre un fichier \_\_init__.py

Puis pour interpréter les résultats:

* `Add Post Build Step` > `Publish Cobertura Coverage Report`

Dans Xml report pattern: `coverage.xml`


* `Add Post Build Step` > `Publish JUnit test result report`

Dans Test report xmls: `nose2-junit.xml`

* `Add Post Build Step` > `Report Violations`

Dans `pylint`: `**/pylint.log` *attention au type de slash*

Dans Source Path pattern: `**/`

* `Add Post Build Step` > `Execute a set of scripts` > `Build steps` > `Executer une commande windows`

Insérer la commande:

	echo off
	setlocal enabledelayedexpansion
	cd %JENKINS_HOME%\jobs\%JOB_NAME%\builds\%BUILD_NUMBER%\violations
	for /f "delims=" %%l in (violations.xml) do (
	    set str=%%l
	    set str=!str:\=/!
	    echo !str! >> violations.tmp
	)
	ren violations.xml violations.old
	ren violations.tmp violations.xml

Cocher:

* Execute script only if build succeeds
* Mark build unstable instead of failed on script error

> ce dernier script permet de corriger le fichier violations.xml et de le rendre lisible par Jenkins


### Lancer le Job

Cliquer sur `Lancer le build`

Les résultats de l'éxecution sont accessibles dans Console Output

Depuis l'écran principal, on a accès aux résultats des tests, à leur couverture, ainsi qu'aux violations pylint