django-jenkins 0.14.1 (beta)

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

For the latest git version, you need the latest pip installed first:

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

Installation for Python 3:

$ pip install git+https://github.com/django/django.git
$ pip install hg+http://hg.logilab.org/pylint
$ pip install coverage
$ # if required
$ pip install pyflakes3k
$ pip install pep8
$ # lettuce and selenium are not yet ported to python 3k

And then, upgrade the pip and install django-jenkins from git as described above.

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 generic tutorial: https://sites.google.com/site/kmmbvnr/home/django-jenkins-tutorial or tutorial for running django-jenkins on ShiningPanda CI https://docs.shiningpanda.com/tutorials/multi-databases/project.html

Settings

• 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. You should specify --all option to ignore this setting.

• 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

  A runner has been added for people using nose in their project. This runner is using django_nose so you will need to have that installed if you want to use this runner.:

  JENKINS_TEST_RUNNER='django_jenkins.nose_runner.CINoseTestSuiteRunner'
  

Tasks

Here is the list of tasks prebuild with django-jenkins

• django_jenkins.tasks.run_pylint

  Runs Pylint over selected Django apps.

  Task-specific settings: PYLINT_RCFILE

• django_jenkins.tasks.with_coverage

  Produces XML coverage report for Jenkins

  Task-specific settings: COVERAGE_RCFILE, COVERAGE_REPORT_HTML_OUTPUT_DIR, COVERAGE_MEASURE_BRANCH, COVERAGE_EXCLUDES, COVERAGE_WITH_MIGRATIONS, COVERAGE_EXCLUDES_FOLDERS

• django_jenkins.tasks.django_tests

  Discovers standard Django test suite from test.py files

• django_jenkins.tasks.dir_tests

  Discover tests from all test*.py files in app subdirectories

• django_jenkins.tasks.run_jshint

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

  You should have the jshint installed

• 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 csslint installed

  Task-specific settings: CSSLINT_INTERPRETER, CSSLINT_CHECKED_FILES

• django_jenkins.tasks.run_pep8

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

  You should have pep8 python package (>=1.3) installed to run this task.

  Task-specific settings: PEP8_RCFILE

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

• django_jenkins.tasks.run_graphmodels

  Graphs an overview of the models of the selected Django apps. Creates models.png graphic (example).

  You should have django-extensions and pygraphviz installed to run this task.

  Task-specific settings:

  • GRAPH_MODELS: A dictionary of settings for graph_models, most corresponding to the command-line options (with 'graphmodels_' removed): fail_without_error, disable_fields, group_models, all_applications, outputfile, layout, verbose_names, language, exclude_columns, exclude_models, inheritance

• django_jenkins.tasks.lettuce_tests

  Discover Lettuce tests from app/feature directories.

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

• django_jenkins.tasks.with_local_celery

  Replacement for djcelery.tests.runners.CeleryTestSuiteRunner Change settings for run Celery tasks locally.

• django_jenkins.tasks.behave_tests

  Discover Behave tests from app/features directories.

  You should have the Behave Python package installed to run this task.

Changelog

Authors

Mikhail Podgurskiy <kmmbvnr@gmail.com>

Contributors:

• Chris Heisel (https://github.com/cmheisel)
• Andrey Fedoseev (https://github.com/andreyfedoseev)
• Jannis Leidel (https://github.com/jezdez)
• Luciano Pacheco (https://github.com/lucmult)
• Julien Lirochon (https://github.com/jlirochon)
• Olivier Girardot (https://github.com/ssaboum)
• Victor Safronovich (https://github.com/suvit)
• Bradley Ayers (https://github.com/bradleyayers)
• Jonas Obrist (https://github.com/ojii)
• John Paulett (https://github.com/johnpaulett)
• Michael Ellingen (https://github.com/mvantellingen)
• Domen Kožar (https://github.com/iElectric)
• Simon Panay (https://github.com/simonpanay)
• Tom Mortimer-Jones (https://github.com/morty)
• Philip Kimmey (https://github.com/philipkimmey)
• Peter Baumgartner (https://github.com/ipmb)
• Kris Kumler (https://github.com/kkumler)
• Axel Haustant (https://github.com/noirbizarre)

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