git-pre-commit-hook 0.0.11

pre-commit hook for Git

Hook that blocks bad commits. Useful for Python-development.

Installation

You can install, upgrade, uninstall git-pre-commit-hook with these commands:

$ pip install git-pre-commit-hook
$ pip install --upgrade git-pre-commit-hook
$ pip uninstall git-pre-commit-hook

Features

• Work fine with initial commit.

• Work fine with all filenames.

• Work with index contents instead of working copy.

• Plugin architecture: adding new checks is easy.

• Builtin plugins for:

  • validate json files

  • validate Python-code with flake8 ( mccabe plugin is enabled ) and pep8-naming

  • validate Python-code with frosted

  • validate .rst files with restructuredtext_lint

  • validate .ini files with configparser

  • validate .yaml files with PyYAML

  • validate .xml files with xml.etree.ElementTree

  • check filesize

Examples

Install hook to current Git-repository:

git-pre-commit-hook install \
  --plugin flake8 \
  --plugin frosted \
  --plugin json \
  --plugin file_size \
  --plugin rst \
  --plugin yaml

Installed hook rejects commits:

• if any file has size greater than 10MB

• if files with .json extension contains invalid JSON

• if Python-code doesn’t pass check with flake8 (with pep8-naming)

• if Python-code doesn’t pass check with frosted

• if files with .rst extension contains invalid RST

• if files with .yaml extension contains invalid YAML

List available plugins:

git-pre-commit-hook list-plugins

Show information about plugin:

git-pre-commit-hook show-plugin-info json

Contributing

1. Fork git-pre-commit-hook

2. Clone your fork

3. Install tox:

   pip install tox

4. Create development environment:

   tox -e devenv
   source devenv/bin/activate

5. Edit code

6. Run tests:

   tox

7. Send pull request

Links

• Fork me on GitHub