不少開發員提交修改的時候都不寫注釋,導致查看歷史時很費勁,也不太符合規范。有的公司要求每次提交修改時都寫上bug號或者任務描述,那么如何在工具上防止開發員們不寫注釋呢?
利用svn的pre-commit鈎子可簡單實現此要求。
進入倉庫project1/hooks目錄,找到pre-commit.tmpl文件,重命名,去掉后綴.tmpl。 編輯pre-commit文件:(Linux系統和windows系統腳本內容見1和2)
1、Linux系統
方法1:
將: $SVNLOOK log -t "$TXN" "$REPOS" | \ grep "[a-zA-Z0-9]" > /dev/null || exit 1 commit-access-control.pl "$REPOS" "$TXN" commit-access-control.cfg || exit 1 這三行注釋掉(前面加#符號), 在此位置添加如下幾行:
LOGMSG=`$SVNLOOK log -t "$TXN" "$REPOS" | grep "[a-zA-Z0-9]" | wc -c` if [ "$LOGMSG" -lt 5 ];#要求注釋不能少於5個字符,您可自定義 then echo -e "\nLog message cann't be empty! you must input more than 5 chars as comment!." 1>&2 exit 1 fi
保存,退出。 給pre-commit添加可執行權限: chmod +x pre-commit 這里記得修改 $SVNLOOK=(svnlook的路徑,/csvn的安裝目錄/bin/svnlook) 配置結束,可以使用了。
方法2:
這兩天把項目的開發機遷移到了linux環境,用python重寫了原來的svn hook,保存為pre-commit放到svn的hooks目錄下,chmod +x pre-commit加上執行權限即可。windows下寫SVN鈎子比較麻煩,只能是批處理或者exe,linux下隨便用什么腳本語言寫都可以,只要加上可執行權限就行了。
#! /usr/bin/env python
# -*- coding: utf-8 -*-
"""
SVN提交前檢查鈎子
功能:
1、強制填寫提交注釋,內容10字節以上
2、強制注釋格式為:xxx:xxx
3、提交文件檢查,過濾不允許提交的文件
"""
import sys
import os
import re
def main(argv):
(repos, txn) = argv
badlist = (".*config\.php$", ".*/php/cache", ".*test", "config\.js$","^.*\.db$")
message = "".join(os.popen("/usr/bin/svnlook log '%s' -t '%s'" % (repos, txn)).readlines()).strip()
if len(message) < 10:
sys.stderr.write("請輸入本次提交的修改內容,10字節以上。");
sys.exit(1)
if message.find(':') < 1:
sys.stderr.write("請按規范填寫注釋,格式為:功能名: 修改說明。");
sys.exit(1)
changelist = os.popen("/usr/bin/svnlook changed '%s' -t '%s'" % (repos, txn)).readlines()
for line in changelist:
for pattern in badlist:
if re.search(pattern, line):
sys.stderr.write("請不要把 %s 加入版本庫。" % line[1:].strip());
sys.exit(1)
sys.exit(0)
if __name__ == "__main__":
main(sys.argv[1:])
2、windows強制注釋腳本
@echo off setlocal
set REPOS=%1 set TXN=%2
rem 保證輸入8個字符 svnlook log %REPOS% -t %TXN% | findstr "........" > nul if %errorlevel% gtr 0 goto :err_action
rem 過濾空格字符 svnlook log %REPOS% -t %TXN% | findstr /ic:" " > nul if %errorlevel% gtr 0 goto :success :err_action echo 你本次版本提交未填寫任何變更的日志說明信息. >&2 echo 請補充日志說明信息后再提交代碼,例如:功能說明等. >&2 echo 輸入的日志信息不少於8個字符說明(或4個漢字),謝謝! >&2 echo *******************禁止空格數據***************** >&2
goto :err_exit
:err_exit exit 1 :success exit 0
