django-jenkins

Plug and play continuous integration with Django and Jenkins

Installation

From PyPI:

$ pip install django-jenkins

Or by downloading the source and running:

$ python setup.py install

Latest git version:

$ pip install -e git+git://github.com/kmmbvnr/django-jenkins.git#egg=django-jenkins
$ pip install coverage

Installation for Python 3:

Works out of the box

Add 'django_jenkins' to your INSTALLED_APPS list. Configure Jenkins to run the following command:

$ ./manage.py jenkins --enable-coverage

This will create reports/ directory with junit xml, Coverage and Pylint reports.

PROJECT_APPS

If present, it is supposed to be a list/tuple of django apps for Jenkins to run. Tests, reports, and coverage are generated only for the apps from this list.
JENKINS_TASKS

List of Jenkins reporters executed by ./manage.py jenkins command.

Default value:
```
JENKINS_TASKS = ()
```
JENKINS_TEST_RUNNER

The name of the class to use for starting the test suite for jenkins command. Class should be inherited from django_jenkins.runner.CITestSuiteRunner

Here is the reporters prebuild with django-jenkins

django_jenkins.tasks.run_pylint

Runs Pylint over selected Django apps.

Task-specific settings: PYLINT_RCFILE

django_jenkins.tasks.run_csslint

Runs CSS lint tools over app/static/*/*.css files. Creates CSS Lint compatible report for Jenkins

You should have the pylint package installed
django_jenkins.tasks.run_scsslint

Runs SCSS lint tools over app/static/*/*.scss files. Creates CSS Lint compatible report for Jenkins

You should have the scss-lint tool installed

django_jenkins.tasks.run_pyflakes

Runs Pyflakes tool over selected Django apps. Creates Pylint compatible report for Jenkins.

You should have Pyflakes python package installed to run this task.

django_jenkins.tasks.run_flake8

Runs flake8 tool over selected Django apps. Creates Pylint compatible report for Jenkins.

You should have flake8 python package installed to run this task.

django_jenkins.tasks.run_sloccount

Runs SLOCCount tool over selected Django apps. Creates sloccount plugin compatible report for Jenkins.

You should have the SLOCCount program installed to run this task.

Set up django-jenkins:

npm install jshint
npm install csslint
PATH=$PATH:$WORKSPACE/node_modules/.bin
tox

Created and maintained by Mikhail Podgurskiy <kmmbvnr@gmail.com>

Special thanks, for all github forks authors for project extensions ideas and problem identifications.