From 9fef45739859842aa62a3b18302ea9960bff18d6 Mon Sep 17 00:00:00 2001
From: Anthony Yeh <enisoc@planetscale.com>
Date: Mon, 16 Dec 2019 22:09:50 -0800
Subject: [PATCH] Add git hook to prompt for DCO signoff. (#15)

Signed-off-by: Anthony Yeh <enisoc@planetscale.com>
---
 CONTRIBUTING.md              | 20 ++++++++++++
 tools/git/commit-msg         |  7 ++++
 tools/git/commit-msg.signoff | 62 ++++++++++++++++++++++++++++++++++++
 tools/git/install-hooks.sh   | 13 ++++++++
 4 files changed, 102 insertions(+)
 create mode 100755 tools/git/commit-msg
 create mode 100755 tools/git/commit-msg.signoff
 create mode 100755 tools/git/install-hooks.sh

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2633068c..937eb8d5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,6 +3,26 @@
 This file is an introduction to the vitess-operator codebase for those looking
 to contribute.
 
+### Developer Certificate of Origin
+
+This project uses a [Developer Certificate of Origin](https://wiki.linuxfoundation.org/dco)
+instead of a Contributor License Agreement.
+
+Please certify each contribution meets the requirements in the
+`DCO` file in the root of this repository by committing with
+the `--signoff` flag (or the short form: `-s`):
+
+```sh
+git commit --signoff
+```
+
+If you contribute often, you may find it useful to install a git hook
+to prompt you to sign off if you forget to add the flag:
+
+```sh
+tools/git/install-hooks.sh
+```
+
 ### CRD API Documentation
 
 It may help to start by reading the user-facing docs for the public API,
diff --git a/tools/git/commit-msg b/tools/git/commit-msg
new file mode 100755
index 00000000..31dc15d7
--- /dev/null
+++ b/tools/git/commit-msg
@@ -0,0 +1,7 @@
+#!/bin/bash
+
+set -euo pipefail
+
+for hook in tools/git/commit-msg.*; do
+  ${hook} "${@}"
+done
diff --git a/tools/git/commit-msg.signoff b/tools/git/commit-msg.signoff
new file mode 100755
index 00000000..82dc688a
--- /dev/null
+++ b/tools/git/commit-msg.signoff
@@ -0,0 +1,62 @@
+#!/bin/bash
+
+# This script is run during "git commit" after the commit message was entered.
+#
+# If it does not find a Signed-off-by: line in this commit,
+# it prints a message about using the -s flag and a link
+# to an explanation of the DCO.
+#
+# If it detects an interactive session, it prompts the user
+# to acknowledge signoff now, and adds the line if so.
+
+msg_file="$1"
+
+git_email="$(git config --get user.email)"
+git_name="$(git config --get user.name)"
+signoff="$(grep -E --max-count=1 "^Signed-off-by: " "$msg_file")"
+
+if [[ "$signoff" =~ Signed-off-by:\ (.*)\ \<(.*)\> ]]; then
+  if [[ "${BASH_REMATCH[1]}" == "${git_name}" && "${BASH_REMATCH[2]}" == "${git_email}" ]]; then
+    # Everything checks out!
+    exit 0
+  fi
+fi
+
+# No signoff found, or the email doesn't match. Print some instructions.
+echo
+echo "==================================================================="
+echo "No 'Signed-off-by:' line was found, or it didn't match the"
+echo "expected author: ${git_name} <${git_email}>"
+echo
+echo "This project uses a Developer Certificate of Origin"
+echo "instead of a Contributor License Agreement."
+echo "For more information, see: https://wiki.linuxfoundation.org/dco"
+echo
+echo "Please certify each contribution meets the requirements in the"
+echo "'DCO' file in the root of this repository by committing with"
+echo "the --signoff flag (or the short form: -s):"
+echo
+echo "    git commit --signoff"
+
+# git doesn't give us access to user input, so let's steal it.
+exec < /dev/tty
+if [[ $? -ne 0 ]]; then
+  # non-interactive shell (e.g. called from Eclipse). Give up here.
+  exit 1
+fi
+
+# Offer to add the signoff line.
+signoff="Signed-off-by: ${git_name} <${git_email}>"
+echo
+echo "Alternatively, you can acknowledge your signoff and continue below:"
+echo
+echo "    ${signoff}"
+echo
+read -r -p "Do you want to add the above signoff and continue? [y/N] "
+
+if [[ "${REPLY,,}" != "y" ]]; then
+  exit 1
+fi
+
+echo >> "${msg_file}"
+echo "${signoff}" >> "${msg_file}"
diff --git a/tools/git/install-hooks.sh b/tools/git/install-hooks.sh
new file mode 100755
index 00000000..75e71d54
--- /dev/null
+++ b/tools/git/install-hooks.sh
@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# Install git hooks.
+
+set -euo pipefail
+
+# Go to repo root.
+DIR="${BASH_SOURCE%/*}"
+cd "${DIR}/../.."
+
+mkdir -p .git/hooks
+ln -sf "../../tools/git/commit-msg" .git/hooks/commit-msg
+git config core.hooksPath .git/hooks