#!/bin/bash # # This commit-msg hook validates commit messages # to ensure that they meet our conventional commit standard. # # # "type: message" # "type(scope): message" # Optionally, append ". Fixes #1234" # # Reference: https://github.com/keymanapp/keyman/wiki/Pull-Request-and-Commit-workflow-notes # # Step 1 - resolve the source directory of the hook, ALSO resolving any symlinks. # From https://stackoverflow.com/a/246128. SCRIPT_SOURCE="${BASH_SOURCE[0]}" while [ -h "$SOURCE" ]; do # resolve $SOURCE until the file is no longer a symlink DIR="$( cd -P "$( dirname "$SCRIPT_SOURCE" )" >/dev/null 2>&1 && pwd )" SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")" [[ $SCRIPT_SOURCE != /* ]] && SCRIPT_SOURCE="$DIR/$SCRIPT_SOURCE" # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located done HOOK_DIRECTORY="$( cd -P "$( dirname "$SCRIPT_SOURCE" )" >/dev/null 2>&1 && pwd )" . $HOOK_DIRECTORY/commit-msg-defs # # Define terminal colours. # if [ -t 2 ]; then t_red=$'\e[1;31m' t_grn=$'\e[1;32m' t_yel=$'\e[1;33m' t_blu=$'\e[1;34m' t_mag=$'\e[1;35m' t_cyn=$'\e[1;36m' t_end=$'\e[0m' fi # # Test the repository upstream/origin: ignore if not keymanapp/keyman # if ! (git remote -v | grep -E "origin|upstream" | grep -q "keymanapp/"); then # Not a Keyman repository. We have no opinion. # echo "Not a Keyman repository. We don't care" exit 0 fi if (git remote -v | grep -E "origin|upstream" | grep -Eq "keyboards|lexical-models"); then # We don't enforce commit messages on keyboards or lexical-models repositories # echo "Keyboards or Lexical-Models. We still don't care." exit 0 fi # If this script is called by another hook, it may insert a -q parameter to silence the help text. QUIET=0 case $1 in -q|--quiet) shift # Remove the parameter, making it equivalent to a standard git-hook call. QUIET=1 ;; esac # build the regex pattern based on the config file function build_regex() { retypes= for type in "${types[@]}" do retypes="${retypes}$type|" done retypes="(${retypes%?})" rescope= for scope in "${scopes[@]}" do rescope="${rescope}$scope|" done # %? removes last | rescope="(\((${rescope%?})\))?" remessage=".{$min_length,$max_length}[^.]" refixes="(\. Fixes #[[:digit:]]+)?" regexp="^${retypes}${rescope}: ${remessage}${refixes}[[:space:]]*$" } # Print out a standard error message which explains # how the commit message should be structured function print_error() { echo -e "\n${t_red}ERROR: Commit message is not in Conventional Commit format" echo -e "----------------------------------------------------------${t_end}" echo -e "Valid types: ${t_grn}${types[@]}${t_end}" echo -e "Valid scopes: ${t_grn}${scopes[@]}${t_end}" echo -e "Max length (first line): ${t_grn}$max_length${t_end}" echo -e "Min length (first line): ${t_grn}$min_length${t_end}" echo -e "Optionally, append ${t_grn}Fixes #1234${t_end}\n" echo -e "${t_cyn}Example:${t_end} fix(windows): Re-attaches the widget plug which had fallen out. Fixes #1111" echo -e "${t_cyn}Reference${t_end}: https://github.com/keymanapp/keyman/wiki/Pull-Request-and-Commit-workflow-notes" echo -e "" echo -e "This script: $0" } # get the first line of the commit message msg=$(head -1 $1) build_regex if [[ ! $msg =~ $regexp ]]; then # commit message is invalid according to config - block commit if [ $QUIET -eq 0 ]; then print_error fi exit 1 fi