Installation

From PyPI:

$ pip install django-jenkins

Or by downloading the source and running:

$ python setup.py install

Or, for the latest git version:

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

Usage

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

$ ./manage.py jenkins

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

For more details see the tutorial: http://sites.google.com/site/kmmbvnr/home/django-hudson-tutorial

Settings

• PROJECT_APPS

  if presents, it is supposed to be a white list of apps for Jenkins run. Tests, reports and coverage are generated only for the apps from this list. You should specify --all option to ignore this settings.

• JENKINS_TASKS

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

  Default value:

  JENKINS_TASKS = (
      'django_jenkins.tasks.run_pylint',
      'django_jenkins.tasks.with_coverage',
      'django_jenkins.tasks.django_tests',
  )
  

• JENKINS_TEST_RUNNER

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

Tasks

Here is the list of tasks prebuild with django-jenkins

• django_jenkins.tasks.run_pylint

  Runs Pylint over selected Django apps.

• django_jenkins.tasks.with_coverage

  Produces XML coverage report for Jenkins

• django_jenkins.tasks.django_tests

  Discovers standard Django test suite from test.py files

• django_jenkins.tasks.run_jslint

  Runs jslint tools over <app>/static/*/*.js files. Creates Pylint compatible report for Jenkins

  You should have the rhino javascript interpreter installed for jslint

• 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 rhino javascript interpreter installed for csslint

• django_jenkins.tasks.run_pep8

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

  You should have pep8 python package installed to run this tasks

• 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 tasks

• 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

• django_jenkins.tasks.lettuce_tests

  Discover Lettuce tests from app/feature directories.

  You should have the Lettuce Python package installed to run this task

Changelog

Authors

Mikhail Podgurskiy <kmmbvnr@gmail.com>

Special thanks, for all github forks authors.

XML Reporting Code from unittest-xml-reporting project:

• Name: Daniel Fernandes Martins <daniel.tritone@gmail.com>
• Company: Destaquenet Technology Solutions <http://www.destaquenet.com/>