利用 Git hook 自動將 branch 名稱放在 commit message 中

Posted on  Nov 20, 2018  in  Git 版本控制  by  Amo Chen  ‐ 2 min read

為了快速修正主線上的嚴重錯誤時,有時會另開一個 hotfix_issue_ooo 之類的分支(branch) ,然後在 commit message 中標上關鍵字 hotfix_issue_ooo 之類的,讓其他開發者知道這是一個 hotfix 。

上述情況,除了用手工標上關鍵字之外,還可以善用 Git 提供的 hook - prepare-commit-msg ,在 commit 時自動產生一些 commit message 。

所以更有效率的方式是利用 prepare-commit-msg 自動將分支名稱放到 commit message 中,如此一來就不需要特別再手動標上關鍵字了。

prepare-commit-msg

<your_repo>/.git/hooks/ 資料夾底下有許多 Git 提供的 hooks 範例,其中一個 prepare-commit-msg.sample 就是本文的主角,利用以下指令複製一份:

$ cd <your_repo>/.git/hooks/
$ cp prepare-commit-msg.sample prepare-commit-msg

接著編輯它:

#!/bin/sh
COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
SHA1=$3

if [ -z "$BRANCHES_TO_SKIP" ]; then
  BRANCHES_TO_SKIP=(master develop test)
fi

BRANCH_NAME=$(git symbolic-ref --short HEAD)

BRANCH_EXCLUDED=$(printf "%s\n" "${BRANCHES_TO_SKIP[@]}" | grep -c "^$BRANCH_NAME$")
BRANCH_IN_COMMIT=$(grep -c "\[$BRANCH_NAME\]" $1)

if [ -n "$BRANCH_NAME" ] && ! [[ $BRANCH_EXCLUDED -eq 1 ]] && ! [[ $BRANCH_IN_COMMIT -ge 1 ]]; then
  sed -i .bak -e "1s/^/[$BRANCH_NAME] /" $COMMIT_MSG_FILE
fi

在此稍微解說一下上述 shell script 。

COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
SHA1=$3

上述是 Git 執行 prepare-commit-msg 時會一併傳進來的變數,是固定格式,因此不用多做修改。

if [ -z "$BRANCHES_TO_SKIP" ]; then
  BRANCHES_TO_SKIP=(master develop test)
fi

上述設定不自動標上分支名稱的 branch ,也就是在 master, develop, test 3 條線上不需要自動標上分支名稱。

BRANCH_NAME=$(git symbolic-ref --short HEAD)

上述取得當前所在的分支名稱。

BRANCH_EXCLUDED=$(printf "%s\n" "${BRANCHES_TO_SKIP[@]}" | grep -c "^$BRANCH_NAME$")
BRANCH_IN_COMMIT=$(grep -c "\[$BRANCH_NAME\]" $1)

if [ -n "$BRANCH_NAME" ] && ! [[ $BRANCH_EXCLUDED -eq 1 ]] && ! [[ $BRANCH_IN_COMMIT -ge 1 ]]; then
  sed -i .bak -e "1s/^/[$BRANCH_NAME] /" $COMMIT_MSG_FILE
fi

最後判斷當前分支名稱是否為不需要自動標上關鍵字的分支,最後用 sed -i .bak -e "1s/^/[$BRANCH_NAME] /" $COMMIT_MSG_FILE$COMMIT_MSG_FILE 檔案中的內容開頭加上 [分支名稱] ,如此一來就完成自動標上分支名稱的任務了!

以上, Happy Coding!

對抗久坐職業傷害

研究指出每天增加 2 小時坐著的時間,會增加大腸癌、心臟疾病、肺癌的風險,也造成肩頸、腰背疼痛等常見問題。

然而對抗這些問題,卻只需要工作時定期休息跟伸展身體即可!

你想輕鬆改變現狀嗎?試試看我們的 PomodoRoll 番茄鐘吧! PomodoRoll 番茄鐘會根據你所設定的專注時間,定期建議你 1 項辦公族適用的伸展運動,幫助你打敗久坐所帶來的傷害!

贊助我們的創作

看完這篇文章了嗎? 休息一下,喝杯咖啡吧!

如果你覺得 MyApollo 有讓你獲得實用的資訊,希望能看到更多的技術分享,邀請你贊助我們一杯咖啡,讓我們有更多的動力與精力繼續提供高品質的文章,感謝你的支持!