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的環境變量