NAME
Git::Hooks::CheckDiff - Git::Hooks plugin to enforce commit policies
VERSION
version 2.12.0
SYNOPSIS
As a Git::Hooks
plugin you don't use this Perl module directly. Instead, you may configure it in a Git configuration file like this:
[githooks]
# Enable the plugin
plugin = CheckDiff
# These users are exempt from all checks
admin = joe molly
[githooks "checkdiff"]
# Reject commits which change lines containing the string COPYRIGHT
shell = /usr/bin/grep COPYRIGHT && false
# Reject commits which add lines containing secrets
shell = /path/to/script/find-secret-leakage-in-git-diff.pl
DESCRIPTION
This Git::Hooks plugin hooks itself to the hooks below to check commit diffs.
pre-commit, pre-applypatch
This hook is invoked before a commit is made to check the diffs that it would record.
update
This hook is invoked multiple times in the remote repository during
git push
, once per branch being updated, to check the differences being committed in it.pre-receive
This hook is invoked once in the remote repository during
git push
, to check the differences being committed in all of of affected references.ref-update
This hook is invoked when a direct push request is received by Gerrit Code Review, to check the differences being committed.
commit-received
This hook is invoked when a push request is received by Gerrit Code Review to create a change for review, to check the differences being committed.
submit
This hook is invoked when a change is submitted in Gerrit Code Review, to check the differences being committed.
patchset-created
This hook is invoked when a push request is received by Gerrit Code Review for a virtual branch (refs/for/*), to check the differences being committed.
To enable this plugin you should add it to the githooks.plugin configuration option:
[githooks]
plugin = CheckDiff
NAME
Git::Hooks::CheckDiff - Git::Hooks plugin to check commit diffs
CONFIGURATION
The plugin is configured by the following git options under the githooks.checkdiff
subsection.
It can be disabled for specific references via the githooks.ref
and githooks.noref
options about which you can read in the Git::Hooks documentation.
shell COMMAND
This directive invokes COMMAND as a single string passed to /bin/sh -c
, which means it can use shell operators such as pipes and redirections.
COMMAND must read from its STDIN the output of git-diff invoked like this:
git diff* -p -U0 --no-color --diff-filter=AM --no-prefix
(The actual sub-command may be diff-index or diff-tree, depending on the actual hook being invoked. The options above are meant to fix the output format.)
The output format of this command is something like this:
diff --git Changes Changes
index cbddd73..2679af9 100644
--- Changes
+++ Changes
@@ -4,0 +5,6 @@ Revision history for perl module Git-Hooks. -*- text -*-
+2.10.1 2018-12-20 21:33:27-02:00 America/Sao_Paulo
+
+[Fix]
+
+ - The hook-specific help-on-error config wasn't being used.
+
diff --git README.pod README.pod
index ead2a0a..2ccfb4d 100644
--- README.pod
+++ README.pod
@@ -72 +72 @@ plugins provided by the distribution are these:
-For a gentler introduction you can read our L<Git::Hooks::Tutorial>. They have
+For a gentler introduction you can read our L<Git::Hooks::Tutorial>. It has
diff --git lib/Git/Hooks.pm lib/Git/Hooks.pm
index c60d098..87fee38 100644
--- lib/Git/Hooks.pm
+++ lib/Git/Hooks.pm
@@ -37 +37 @@ BEGIN { ## no critic (RequireArgUnpacking)
- package => scalar(caller(1)),
+ package => scalar(caller),
It's up to COMMAND to check the diff and exit with a code telling if everything is fine (0) or if there is something wrong in it (not 0). Any output from COMMAND (STDOUT or STDERR) will end up being shown to the user.
The script find-secret-leakage-in-git-diff.pl, which is part of the Git::Hooks module, is a good example of a script which can detect problems in a Git diff.
AUTHOR
Gustavo L. de M. Chaves <gnustavo@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2020 by CPqD <www.cpqd.com.br>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.