This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


Git pre-commit hook for checking coding style of Python code. The hook requires pep8. It will check files with the .py extension and files that contain #! (shebang) and python in the first line. Heavily inspired by and partly based on git-pylint-commit-hook by Sebastian Dahlgren.

Since pep8 itself, by default, looks for a setup.cfg file in the repository root directory, so does this script. The script works without the setup.cfg file. The options for the script can either be placed in the [pep8_pre_commit_hook] section of the configuration file or be passed as command line parameters. If the same option is specified in both the configuration file and the parameters, the configuration file takes precedence.


Install via PyPI

pip install git_pep8_commit_hook


Having installed the script, if you add it to your pre-commit file which should be placed in the hooks subfolder for the Git folder (usually .git/hooks), it will be called automatically when you run git commit. If you want to skip the checks for a certain commit, you can add the -n flag and run git commit -n.


By default, the script looks for a setup.cfg in the root directory of your repository. If the script does not find a configuration file, it uses default settings. The file might look like this:

ignore = E226,E302,E41
max-line-length = 79

max-violations-per-file = 5

The [pep8] section is used by pep8. The [pep8_pre_commit_hook] section is used by the commit hook script. You may specify the following options:

  • pep8-command is for the actual command, for instance if pep8 is not installed globally, but is in a virtualenv inside the project itself.
  • pep8-params lets you pass custom parameters to pep8
  • max-violations-per-file lets you specify how many violations of the PEP 0008 standard you are willing to accept for any file. If at least one file has more than the specified number of violations, the commit will be blocked. The default value is 0.

Alternatively you can pass the above directly to the commit hook script as arguments. In addition to the above, you can also pass the following arguments to the script:

  • config lets you specify an alternative config file for both pep8 itself and the commit hook script.
  • version displays the current version of the commit hook script.
  • help displays a help message explaining the arguments.

Running tests

The tests are written using pytest. You can run the tests without installing pytest and without installing the script by typing python Alternatively, you can install pytest by running pip install pytest. The script itself can be installed in development mode by running pip install -e . from the root directory of the repository. Then the tests can be run by executing py.test.


This commit hook is written in Python and has the following requirements:

  • pep8 (sudo pip install pep8)
  • Python >= 2.7

Release notes

0.1.0 (2015-09-11)

  • Initial release.
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
git_pep8_commit_hook-0.1.0-py2.py3-none-any.whl (8.8 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Sep 11, 2015
git_pep8_commit_hook-0.1.0.tar.gz (9.7 kB) Copy SHA256 Checksum SHA256 Source Sep 11, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting