https://github.com/kmmbvnr/django-jenkins

Plug and play continuous integration with django and jenkins
https://github.com/kmmbvnr/django-jenkins

django jenkins jenkins-ci test testing unit-testing

Last synced: 5 days ago
JSON representation

Plug and play continuous integration with django and jenkins

• Host: GitHub
• URL: https://github.com/kmmbvnr/django-jenkins
• Owner: kmmbvnr
• License: lgpl-3.0
• Created: 2010-07-02T08:55:14.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2022-03-29T15:06:39.000Z (almost 3 years ago)
• Last Synced: 2025-01-10T05:09:40.124Z (12 days ago)
• Topics: django, jenkins, jenkins-ci, test, testing, unit-testing
• Language: Python
• Homepage:
• Size: 489 KB
• Stars: 945
• Watchers: 25
• Forks: 278
• Open Issues: 19
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
django-jenkins

==============

Plug and play continuous integration with Django and Jenkins

.. image:: https://img.shields.io/pypi/v/django-jenkins.svg

    :target: https://pypi.python.org/pypi/django-jenkins

.. image:: https://requires.io/github/kmmbvnr/django-jenkins/requirements.png?branch=master

   :target: https://requires.io/github/kmmbvnr/django-jenkins/requirements/?branch=master

.. image:: https://badges.gitter.im/Join%20Chat.svg

        :target: https://gitter.im/kmmbvnr/django-jenkins?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

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

Usage

-----

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.

For more details see the generic tutorial: https://sites.google.com/site/kmmbvnr/home/django-jenkins-tutorial

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.

- ``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``

Reporters

---------

Here is the reporters prebuild with django-jenkins

- ``django_jenkins.tasks.run_pylint``

  Runs Pylint_ over selected Django apps.

  Task-specific settings: ``PYLINT_RCFILE``

.. _Pylint: http://www.logilab.org/project/pylint

- ``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``

.. _pep8: http://pypi.python.org/pypi/pep8

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

.. _Pyflakes: http://pypi.python.org/pypi/pyflakes

- ``django_jenkins.tasks.run_flake8``

  Runs flake8 tool over selected Django apps.

  Creates pep8 compatible report for Jenkins.

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

.. _flake8: http://pypi.python.org/pypi/flake8

Changelog

---------

GIT Version

~~~~~~~~~~~~~~~~~~

* csslint/jshint/sccsLint/sloccount task removed (could be used as standalone tools)

Contribution guide

~~~~~~~~~~~~~~~~~~

* Set up local jenkins

* Set up django-jenkins::

    npm install jshint

    npm install csslint

    PATH=$PATH:$WORKSPACE/node_modules/.bin

    tox

* Ensure that everything works

* Modify the *the only one thing*

* Ensure that everything works again

* Fix pep8/pyflakes errors and minimize pylint's warnings

* Pull request!

Authors

-------

Created and maintained by Mikhail Podgurskiy 

Contributors: https://github.com/kmmbvnr/django-jenkins/graphs/contributors

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