README.md 5.9 KB
Newer Older
Anthony Sottile's avatar
Anthony Sottile 已提交
1
[![Build Status](https://travis-ci.org/pre-commit/pre-commit-hooks.svg?branch=master)](https://travis-ci.org/pre-commit/pre-commit-hooks)
Anthony Sottile's avatar
Anthony Sottile 已提交
2
[![Coverage Status](https://coveralls.io/repos/github/pre-commit/pre-commit-hooks/badge.svg?branch=master)](https://coveralls.io/github/pre-commit/pre-commit-hooks?branch=master)
Anthony Sottile's avatar
Anthony Sottile 已提交
3
[![Build status](https://ci.appveyor.com/api/projects/status/dfcpng35u4g0r0t1/branch/master?svg=true)](https://ci.appveyor.com/project/asottile/pre-commit-hooks/branch/master)
Anthony Sottile's avatar
Anthony Sottile 已提交
4

Anthony Sottile's avatar
Anthony Sottile 已提交
5
6
7
8
9
pre-commit-hooks
==========

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

Anthony Sottile's avatar
Anthony Sottile 已提交
10
See also: https://github.com/pre-commit/pre-commit
Anthony Sottile's avatar
Anthony Sottile 已提交
11
12
13
14
15
16
17


### Using pre-commit-hooks with pre-commit

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

    -   repo: git://github.com/pre-commit/pre-commit-hooks
Anthony Sottile's avatar
v1.2.2    
Anthony Sottile 已提交
18
        sha: v1.2.2  # Use the ref you want to point at
Anthony Sottile's avatar
Anthony Sottile 已提交
19
20
21
22
23
24
25
        hooks:
        -   id: trailing-whitespace
        # -   id: ...


### Hooks available

26
- `autopep8-wrapper` - Runs autopep8 over python source.
27
    - Ignore PEP 8 violation types with `args: ['-i', '--ignore=E000,...']` or
28
29
      through configuration of the `[pycodestyle]` section in
      setup.cfg / tox.ini.
30
- `check-added-large-files` - Prevent giant files from being committed.
31
    - Specify what is "too large" with `args: ['--maxkb=123']` (default=500kB).
32
33
    - If `git-lfs` is installed, lfs files will be skipped
      (requires `git-lfs>=2.2.1`)
34
- `check-ast` - Simply check whether files parse as valid python.
35
36
- `check-builtin-literals` - Require literal syntax when initializing empty or zero Python builtin types.
    - Allows calling constructors with positional arguments (e.g., `list('abc')`).
37
    - Allows calling constructors from the `builtins` (`__builtin__`) namespace (`builtins.list()`).
38
39
    - Ignore this requirement for specific builtin types with `--ignore=type1,type2,…`.
    - Forbid `dict` keyword syntax with `--no-allow-dict-kwargs`.
40
- `check-byte-order-marker` - Forbid files which have a UTF-8 byte-order marker
41
42
43
44
- `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.
45
46
- `check-executables-have-shebangs` - Checks that non-binary executables have a
  proper shebang.
Anthony Sottile's avatar
Anthony Sottile 已提交
47
- `check-json` - Attempts to load all json files to verify syntax.
48
- `check-merge-conflict` - Check for files that contain merge conflict strings.
49
- `check-symlinks` - Checks for symlinks which do not point to anything.
50
- `check-vcs-permalinks` - Ensures that links to vcs websites are permalinks.
Anthony Sottile's avatar
Anthony Sottile 已提交
51
- `check-xml` - Attempts to load all xml files to verify syntax.
Anthony Sottile's avatar
Anthony Sottile 已提交
52
- `check-yaml` - Attempts to load all yaml files to verify syntax.
53
54
    - `--allow-multiple-documents` - allow yaml files which use the
      [multi-document syntax](http://www.yaml.org/spec/1.2/spec.html#YAML)
Anthony Sottile's avatar
Anthony Sottile 已提交
55
- `debug-statements` - Check for pdb / ipdb / pudb statements in code.
56
57
58
- `detect-aws-credentials` - Checks for the existence of AWS secrets that you
  have set up with the AWS CLI.
  The following arguments are available:
59
  - `--credentials-file` - additional AWS CLI style configuration file in a
60
61
    non-standard location to fetch configured credentials from. Can be repeated
    multiple times.
62
63
64
- `detect-private-key` - Checks for the existence of private keys.
- `double-quote-string-fixer` - This hook replaces double quoted strings
  with single quoted strings.
Anthony Sottile's avatar
Anthony Sottile 已提交
65
- `end-of-file-fixer` - Makes sure files end in a newline and only a newline.
66
67
- `fix-encoding-pragma` - Add `# -*- coding: utf-8 -*-` to the top of python files.
    - To remove the coding pragma pass `--remove` (useful in a python3-only codebase)
Dan's avatar
Dan 已提交
68
- `file-contents-sorter` - Sort the lines in specified files (defaults to alphabetical). You must provide list of target files as input to it. Note that this hook WILL remove blank lines and does NOT respect any comments.
69
- `flake8` - Run flake8 on your python files.
70
- `forbid-new-submodules` - Prevent addition of new git submodules.
71
72
73
74
75
- `mixed-line-ending` - Replaces or checks mixed line ending.
    - `--fix={auto,crlf,lf,no}`
        - `auto` - Replaces automatically the most frequent line ending. This is the default argument.
        - `crlf`, `lf` - Forces to replace line ending by respectively CRLF and LF.
        - `no` - Checks if there is any mixed line ending without modifying any file.
76
77
- `name-tests-test` - Assert that files in tests/ end in `_test.py`.
    - Use `args: ['--django']` to match `test*.py` instead.
78
79
- `no-commit-to-branch` - Protect specific branches from direct checkins.
    - Use `args: -b <branch> ` to set the branch. `master` is the default if no argument is set.
80
- `pyflakes` - Run pyflakes on your python files.
81
82
83
- `pretty-format-json` - Checks that all your JSON files are pretty.  "Pretty"
  here means that keys are sorted and indented.  You can configure this with
  the following commandline options:
84
    - `--autofix` - automatically format json files
85
    - `--indent ...` - Control the indentation (either a number for a number of spaces or a string of whitespace).  Defaults to 4 spaces.
86
    - `--no-sort-keys` - when autofixing, retain the original key ordering (instead of sorting the keys)
87
    - `--top-keys comma,separated,keys` - Keys to keep at the top of mappings.
88
- `requirements-txt-fixer` - Sorts entries in requirements.txt
89
- `sort-simple-yaml` - Sorts simple YAML files which consist only of top-level keys, preserving comments and blocks.
Anthony Sottile's avatar
Anthony Sottile 已提交
90
- `trailing-whitespace` - Trims trailing whitespace.
91
92
93
94
    - 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.
Anthony Sottile's avatar
Anthony Sottile 已提交
95
96
97
98
99
100
101

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