使用SVN鈎子強制提交日志和限制提交文件類型


Subversion本身有很好的擴展性,用戶可以通過鈎子實現一些自定義的功能。所謂鈎子實際上是一種事件機制,當系統執行到某個特殊事件時,會觸發我們預定義的動作,這樣的特殊事件在Subversion里有很多。那么SVN的鈎子有哪些呢?下面簡單介紹下:

服務器鈎子:

鎖定的2種

pre-lock

鈎子在每次有人嘗試鎖定文件時執行。可以防止完全鎖定,或者用來創建控制哪些用戶可以鎖定哪些路徑的復雜策略。如果鈎子發現已存在鎖,也可以決定是否允許用戶“竊取”這個鎖。

post-lock

在路徑鎖定后執行。通常用來發送鎖定事件郵件通知。

解鎖的2種

pre-unlock

鈎子在某人企圖刪除一個文件上的鈎子時發生。可以用來創建哪些用戶可以解鎖哪些文件的策略。制定解鎖策略非常重要。如果用戶 A 鎖定了一個文件,允許用戶B 打開這個鎖?如果這個鎖已經一周了呢?這種事情可以通過鈎子決定並強制執行。

post-unlock

在一個或多個路徑已經被解鎖后執行。通常用來發送解鎖事件通知郵件。

提交的3種

start-commit

它在提交事務產生前已運行,通常用來判定一個用戶是否有權提交。版本庫傳給該程序兩個參數:到版本庫的路徑,和要進行提交的用戶名。如果程序返回一個非零值,會在事務產生前停止該提交操作。如果鈎子程序要在stderr中寫入數據,它將排隊送至客戶端。

pre-commit

在事務完成提交之前運行,通常這個鈎子是用來保護因為內容或位置(例如,你要求所有到一個特定分支的提交必須包括一個bug追蹤的ticket號,或者是要求日志信息不為空)而不允許的提交。版本庫傳遞兩個參數到程序:版本庫的路徑和正在提交的事務名稱,如果程序返回非零值,提交會失敗,事務也會刪除。如 果鈎子程序在stderr中寫入了數據,也會傳遞到客戶端。

post-commit

它在事務完成后運行,創建一個新的修訂版本。大多數人用這個鈎子來發送關於提交的描述性電子郵件,或者作為版本庫的備份。版本庫傳給程序兩個參數:到版本庫的路徑和被創建的新的修訂版本號。退出程序會被忽略。

屬性的2種

pre-revprop-change

因為Subversion的修訂版本屬性不是版本化的,對這類屬性的修改(例如提交日志屬性svn:log)將會永久覆蓋以前的屬性值。因為數據在此可能 丟失,所以Subversion提供了這種鈎子(及與之對應的post-revprop-change),因此版本庫管理員可用一些外部方法記錄變化。作 為對丟失未版本化屬性數據的防范,Subversion客戶端不能遠程修改修訂版本屬性,除非為你的版本庫實現這個鈎子。

post-revprop-change

這個鈎子與pre-revprop-change對應。事實上,因為多疑的原因,只有存在pre-revprop-change時這個腳本才會執行。當這 兩個鈎子都存在時,post-revprop-change在修訂版本屬性被改變之后運行,通常用來發送包含新屬性的email。版本庫傳遞四個參數給該 鈎子:到版本庫的路徑,屬性存在的修訂版本,經過校驗的產生變化的用戶名,和屬性自身的名字。

客戶端鈎子:

提交的

start commit hook

pre-commit hook

post-commit hook

更新的

start update hook

pre-update hook

post-update hook

今天研究了一下如何使用SVN鈎子強制提交日志和限制提交文件類型。這次我們用到的是服務端鈎子pre-commit。網上有篇文章使用jscript來實現這個功能:Windows下WSH/JS實現SVN服務器鈎子腳本阻止提交空日志信息和垃圾文件。我測試過該文章,發現提交限制文件時確實有效,但是提交正常的源碼文件時卻陷入一種類似死循環的等待中。我的測試環境是:客戶端 Win XP + sp3,服務器端:WinServer2008 Enterprise。

為此只好自己參考網上的代碼自己寫了一下,代碼如下:

@echo 
rem SVN強制寫注釋的hooks腳本(Windows)
rem 文件名是: pre-commit.bat,放到repository/hooks目錄下
setlocal
set SVN_BINDIR="C:\Program Files (x86)\SlikSvn\bin"
set REPOS=%1
set TXN=%2

rem 檢查是否提交日志
%SVN_BINDIR%\svnlook log -t "%TXN%" "%REPOS%" | findstr "......" > nul
if %errorlevel% gtr 0 goto nolog

rem 過濾文件類型
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "obj$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "pdb$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "idb$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "manifest$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "pch$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "res$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "exp$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "ilk$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "dep$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "user$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "suo$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "ncb$"
if %errorlevel% EQU 0 (goto SuffixError)
%SVN_BINDIR%\svnlook changed -t "%TXN%" "%REPOS%" | findstr "aps$"
if %errorlevel% EQU 0 (goto SuffixError)

exit 0
:SuffixError
echo 請不要提交受限制的文件類型,如:obj、pdb、exp、ilk等等,謝謝! 1>&2
exit 1
:nolog
echo 日志(Message)是跟蹤文檔的重要信息,必須輸入,不得輸入無意義字符,長度不得小於6個字符。 1>&2
exit 1

​ 簡單說明下:SVN_BINDIR路徑為你的SVN服務端程序所在的目錄,svnlookchanged -t "%TXN%" "%REPOS%" | findstr "obj$"為比較你提交的文件是否為obj文件(即后綴是否為obj)。

​ 部署方式是將上面的批處理代碼保存在pre-commit.bat(必須是這個名字),然后把它放到服務端的版本庫的hooks文件夾下。該腳本經測試有效,測試環境為客戶端 Win XP + sp3,服務器端:Win Server2008 Enterprise。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM