Enhancement request for installing git hook strictness

Please describe how you installed Flake8

See #334 (closed)

Please describe the problem or feature

By default the git commit hook is not strict, which while documented at http://flake8.pycqa.org/en/latest/user/using-hooks.html#preventing-commits will surprise many people.

Currently there is no output from the installation command:

$ flake8 --install-hook git
(no output at all)

I would find it helpful if it did:

$ flake8 --install-hook git
Git hook installed, currently NOT using strict mode.
Enable this with `git config --bool flake8.strict true`

or (depending on the user's global or preexisting setting):

$ flake8 --install-hook git
Git hook installed, currently using strict mode.
Disable this with `git config --bool flake8.strict false`

mentioned in issue #334 (closed)

mentioned in issue #243 (closed)

I think that what we should do is provide users a link to how to use the hooks. I'm happy to add more output but only mentioning strict will imply that's the only thing worth bringing up. There are several ways to tweak/tune the hook. We should either document all of them in the output or point them to the existing documentation and make sure to continually improve that.

@pjacock does the above sound reasonable?

Yes, having flake8 --install-hook git say something like Git hook installed, see <URL> for configuration options. sounds like a good solution.

@pjacock I'd happily merge a pull request that prints that on installation. :)

mentioned in merge request !198 (merged)

closed

Fixed in !198 (merged)

changed milestone to %3.5.0