Skip to main content

Kwalitee is a tool that runs static analysis checks on Git repository.

Project description

==========
Kwalitee
==========

.. image:: https://travis-ci.org/inveniosoftware/kwalitee.svg?branch=master
:target: https://travis-ci.org/inveniosoftware/kwalitee
.. image:: https://coveralls.io/repos/inveniosoftware/kwalitee/badge.svg?branch=master
:target: https://coveralls.io/r/inveniosoftware/kwalitee


Installation
============

.. seealso:: :ref:`_installation`

Git Hooks
=========
Install git hooks into your repository using::

cd /path/to/git-repo
kwalitee githooks install

and uninstall hooks using::

kwalitee githooks uninstall

Following hooks are installed:

* ``pre-commit`` - run PEP8, pyflakes and copyright year checks on files
being committed. If errors are found, the commit is aborted.
* ``prepare-commit-msg`` - prepare standard form commit message.
* ``post-commit`` - check commit message form and signatures. If errors are
found, they can be fixed with ``git commit --amend``.

All checks can be disabled using::

git commit --no-verify


Kwalitee checks
===============

* Static analysis of files:
* `pyflakes <https://launchpad.net/pyflakes>`_
* `PEP8 <http://legacy.python.org/dev/peps/pep-0008/>`_
* `PEP257 <http://legacy.python.org/dev/peps/pep-0257/>`_
* Copyright year in license

* Commit message analysis:
* First line less than 50 chars and according to the
pattern ``<component>: <short description>`` (using nouns).
* Body with detailed description of what this patch does, formatted as a
bulletted list. (using present tense).
* Required signatures: ``Signed-off-by`` and ``Reviewed-by``.


License
=======
Copyright (C) 2014, 2015 CERN.

kwalitee is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

kwalitee is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with kwalitee; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

In applying this licence, CERN does not waive the privileges and immunities granted to it by virtue of its status as an Intergovernmental Organization or submit itself to any jurisdiction.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kwalitee-0.2.0rc8.tar.gz (107.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page