Some out-of-the-box hooks for pre-commit
Find a file
Alexander Dupuy a6023ac0d7 Implement Markdown trailing space line break preservation
Markdown uses two or more trailing spaces on a line to indicate a forced
line break `<br/>` - these will be preserved for files with a markdown
extension (default = `.md` or `.markdown`).

Add `--markdown-linebreak-ext=X,Y` to add extensions (`*` matches any),
and `--no-markdown-linebreak-ext` to disable this feature.

If you want to set specific extension `foo` only (and not md/markdown),
use `--no-markdown-linebreak-ext --markdown-linebreak-ext=foo`

Tries to prevent --markdown-linebreak-ext from eating filenames as if they were
extensions by rejecting any with '.' or '/' (or even Windows-style '\' or ':')

Update README.md to include information on these arguments as well as
arguments added to other hooks

Add extensive tests using pytest.mark.parametrize

test that `txt` file is not considered as 'txt' extension
test that `.txt` file is not considered as 'txt' extension

The latter is the (correct) behavior of os.path.splitext(), and an example
of why it is better to use the libraries than to mangle strings yourself.
2015-05-11 08:52:32 +02:00
pre_commit_hooks Implement Markdown trailing space line break preservation 2015-05-11 08:52:32 +02:00
testing Remove dependency on plumbum 2015-03-20 14:15:30 -07:00
tests Implement Markdown trailing space line break preservation 2015-05-11 08:52:32 +02:00
.coveragerc Remove timid coverage. 2014-06-05 15:52:56 -07:00
.gitignore Update pre-commit config. 2014-06-05 09:23:49 -07:00
.pre-commit-config.yaml Bump to latest hooks 2015-03-08 11:34:33 -07:00
.travis.yml Add check-xml hook. 2015-01-17 10:30:58 -08:00
appveyor.yml Add appveyor 2015-01-19 17:19:03 -08:00
CHANGELOG v0.4.1 2015-03-08 12:32:40 -07:00
hooks.yaml Add eyaml support for check-yaml hook 2015-04-16 13:53:19 +10:00
LICENSE MIT 2014-06-05 08:58:48 -07:00
Makefile requirements_dev -> requirements-dev 2014-06-05 09:09:21 -07:00
pylintrc Implement Markdown trailing space line break preservation 2015-05-11 08:52:32 +02:00
README.md Implement Markdown trailing space line break preservation 2015-05-11 08:52:32 +02:00
requirements-dev.txt Add check-xml hook. 2015-01-17 10:30:58 -08:00
requirements.txt Update project setup. 2014-04-13 22:09:26 -07:00
setup.py Remove dependency on plumbum 2015-03-20 14:15:30 -07:00
tox.ini Add check-xml hook. 2015-01-17 10:30:58 -08:00

Build Status Coverage Status Build status

pre-commit-hooks

Some out-of-the-box hooks for pre-commit.

See also: https://github.com/pre-commit/pre-commit

Using pre-commit-hooks with pre-commit

Add this to your .pre-commit-config.yaml

-   repo: git://github.com/pre-commit/pre-commit-hooks
    sha: ''  # Use the sha you want to point at
    hooks:
    -   id: trailing-whitespace
    # -   id: ...

Hooks available

  • autopep8-wrapper - Runs autopep8 over python source.
    • Ignore PEP 8 violation types with args: ['-i', '--ignore=E000,...'], see .pre-commit-config.yaml in this repository for an example.
  • check-added-large-files - Prevent giant files from being committed.
    • Specify what is "too large" with args: ['--maxkb=123'] (default=500kB).
  • check-case-conflict - Check for files with names that would conflict on a case-insensitive filesystem like MacOS HFS+ or Windows FAT.
  • check-docstring-first - Checks for a common error of placing code before the docstring.
  • check-json - Attempts to load all json files to verify syntax.
  • check-merge-conflict - Check for files that contain merge conflict strings.
  • check-xml - Attempts to load all xml files to verify syntax.
  • check-yaml - Attempts to load all yaml files to verify syntax.
  • debug-statements - Check for pdb / ipdb / pudb statements in code.
  • detect-private-key - Checks for the existence of private keys.
  • double-quote-string-fixer - This hook replaces double quoted strings with single quoted strings.
  • end-of-file-fixer - Makes sure files end in a newline and only a newline.
  • flake8 - Run flake8 on your python files.
  • name-tests-test - Assert that files in tests/ end in _test.py.
    • Use args: ['--django'] to match test*.py instead.
  • pyflakes - Run pyflakes on your python files.
  • requirements-txt-fixer - Sorts entries in requirements.txt
  • trailing-whitespace - Trims trailing whitespace.
    • Markdown linebreak trailing spaces preserved for .md and.markdown; use args: ['--markdown-linebreak-ext=txt,text'] to add other extensions, args: ['--markdown-linebreak-ext=*'] to preserve them for all files, or args: ['--no-markdown-linebreak-ext'] to disable and always trim.

As a standalone package

If you'd like to use these hooks, they're also available as a standalone package.

Simply pip install pre-commit-hooks