Add VTK-specific local commit hooks

Add ".hooks-config.bash" to tell the main hooks to chain to our hooks.
Add a pre-commit hook that cooperates with SetupForDevelopment.sh to
ensure the user has run the most recent hook setup script.  Add a
prepare-commit-msg hook to mention the "WIP:" prefix in the standard
commented commit message instructions.

Change-Id: I034afb64aa4fbbcaafd70d8a57493495d8736181

.gitattributes

 .git*            export-ignore
+.hooks*          export-ignore
 
 *.sh             crlf=input
 newalpha         crlf=input

.hooks-config.bash

+# Loaded by .git/hooks/(pre-commit|commit-msg|prepare-commit-msg)
+# during git commit after local hooks have been installed.
+
+hooks_chain_pre_commit="Utilities/Scripts/pre-commit"
+hooks_chain_commit_msg="Utilities/Scripts/commit-msg"
+hooks_chain_prepare_commit_msg="Utilities/Scripts/prepare-commit-msg"

Utilities/Scripts/pre-commit

+#!/usr/bin/env bash
+
+egrep-q() {
+  egrep "$@" >/dev/null 2>/dev/null
+}
+
+die() {
+  echo 'pre-commit hook failure' 1>&2
+  echo '-----------------------' 1>&2
+  echo '' 1>&2
+  echo "$@" 1>&2
+  exit 1
+}
+
+#-----------------------------------------------------------------------------
+
+# Check that developmer setup is up-to-date.
+lastSetupForDevelopment=$(git config --get hooks.SetupForDevelopment || echo 0)
+eval $(grep '^SetupForDevelopment_VERSION=' "${BASH_SOURCE%/*}/../SetupForDevelopment.sh")
+test -n "$SetupForDevelopment_VERSION" || SetupForDevelopment_VERSION=0
+if test $lastSetupForDevelopment -lt $SetupForDevelopment_VERSION; then
+  die 'Developer setup in this work tree is out of date.  Please re-run
+
+  Utilities/SetupForDevelopment.sh
+'
+fi

Utilities/Scripts/prepare-commit-msg

+#!/usr/bin/env bash
+
+egrep-q() {
+  egrep "$@" >/dev/null 2>/dev/null
+}
+
+# First argument is file containing commit message.
+commit_msg="$1"
+
+# Check for our extra instructions.
+egrep-q "^# Start the commit message" -- "$commit_msg" && return 0
+
+# Insert our extra instructions.
+commit_msg_tmp="$commit_msg.$$"
+sed 's/^# \(On\|Not currently on any\) branch.*/'\
+'# Start the commit message in "WIP: " to indicate Work In Progress\
+# that is not yet ready to merge.\
+#\
+&/' "$commit_msg" > "$commit_msg_tmp" &&
+mv "$commit_msg_tmp" "$commit_msg"

Utilities/SetupForDevelopment.sh

@@ -11,3 +11,7 @@ Utilities/Scripts/GitTips.sh
 # Rebase master by default
 git config rebase.stat true
 git config branch.master.rebase true
+
+# Record the version of this setup so Scripts/pre-commit can check it.
+SetupForDevelopment_VERSION=1
+git config hooks.SetupForDevelopment ${SetupForDevelopment_VERSION}