git_stats安裝及使用

 git_stats是倉庫程式碼統計工具，今天我們要求用git_stats工具做專案的程式碼統計，也是一步一坑的找到了一些方法，在這裡記錄一下

Window環境安裝與使用

git_stats可以在windows和linux使用,但是整合方式有點不太一樣，我目前嘗試的是win版本的，在這裡就先記錄win版本的安裝及使用，Linux環境的後期需要可以再補充

gitstats 依賴 Git 、Python 以及Gnuplot。

版本說明：

-python（>=2.6.0），在這裡作為指令碼進行執行

-Git( >= 1.5.2.4 ） 分散式版本控制系統

-Gnuplot ( >= 4.0.0 ) 進行畫圖的工具

1.安裝python

1.1.下載及安裝

由於只支援Python2，可以到官網https://www.python.org/downloads/release/python-2713/進行下載獲取python的win下的安裝包。

此處安裝的是python 2.7.14

為什麼最好是python2？

gitstats 是基於python2.x版本進行開發的一個開源的程式專案，所以需要安裝python2.x版本的直譯器，由於python的特殊性，gitstats中的某些程式碼在python3.x中不能執行。會出現語法錯誤。

如果有多個python版本時，如何操作？

將python的2.x版本的安裝目錄下的python.exe檔案修改為python2.exe,以免多個python互相沖突; 在環境變數path中增加python2的檔案路徑

1.2配置環境變數

安裝完以後需要配置環境變數，例如安裝在D:\Python27 ，則在環境變數path中增加D:\Python27.

win10：此電腦-屬性-高階系統設定-環境變數：找到path，新增上python本地的安裝路徑

1.3驗證：
檢視python安裝是否成功:使用win+R,輸入cmd,執行python -version,出現版本號,或輸入python，顯示版本號  我的是Python 2.7.14

 

2.安裝git_stats

　可以從https://github.com/hoxu/gitstats下載gitstats 

　下載完成後，需要進入gitstats資料夾下面,將gitstats檔案複製一份並命名或者直接重新命名為gitstats.py

 

 3.安裝Gnuplot

3.1下載安裝包

　可以到https://sourceforge.net/projects/gnuplot/files/gnuplot/5.0.6/, 選擇最新的win版本下載即可。

　3.2配置環境變數

　根據你的安裝目錄直接配置環境變數即可,例如直接將E:\gnuplot\bin新增到path中即可.

　檢視是否安裝成功:使用win+r,輸入cmd,執行gnuplot,出現下面的輸出就是成功啦 

 

4.生成文件方法

方法1：

我們切換到git專案根目錄下,右鍵選擇git bash here,使用的命令格式

如:python [gitstats.py路徑] [git庫路徑(git專案根目錄)] [輸出結果路徑],

我的命令就是下面這個python '/d/Program Files/gitstats-master/gitstats.py' . stats,

其中.表示當前目錄,stats表示生成到當前的stats目錄裡面. 

 

但我用在git中試沒成功，我操作成功的是用黑視窗操作的，就是下面這個方法

方法2：

1.開啟黑視窗，啟動cmd

2.進入gitstats路徑位置 cd 檔案路徑

3.建立gitstats的輸出資料夾

python gitstats.py “gitstats文件庫路徑” “輸出資料夾路徑

舉例： python gitstats.py  D:\Program Files\IDEA     D:\results

 

 

或者直接在cmd下操作

 python gitstats.py路徑  ' gitstats文件庫路徑'  '輸出資料夾路徑'

 舉例： python D:\Program Files\gitstats-master\gitstats.py  D:\Program Files\IDEA     D:\results

 

哪一種都可以，輸入成功後點選回車

 

4.展示資料

windows裡面展示資料就比較方便了,只要你有瀏覽器就可以

進入輸出資料夾stats路徑,點選index.html，開啟方式選擇瀏覽器進行展示資料,即可獲得專案的基本資料和commit提交記錄的流圖

當然也可以切換成不同的tab進行檢視

 

至於具體的使用方法,隨便點兩下就明白了,這裡就先不多說了.一般我經常用到的就是Activity和Authors這兩個.

遇到的問題：

問題1：wc不是內部命令

原因：經查詢發現是git\usr\bin下的可執行檔案沒有被加入全域性變數，導致檔案在編譯的過程中，沒能識別出wc程式,

解決：找到git目錄下的usr下的bin目錄，放到環境變數path中

 

 

 

問題2：剛剛只解決了wc的問題，git不是內部命令 的問題也不能忽視

解決方法：①找到安裝git的位置，然後在該目錄的子目錄下分別找到git-core、bin 兩個目錄，我的安裝在了D盤，所以兩個目錄分別是：如圖

 

 此次只遇到的是這兩個問題，配置了環境變數後，關閉黑視窗，再次按上面步驟操作，執行成功

 問題3：這個問題是其他同事遇到的，也在這裡記錄一下，

是因為在之前使用Git bash的時候，不需要把Git bash 的可執行檔案加入path的環境變數