gitstats 是一款git历史统计工具,可以生成定量的统计数据,并以html图表的形式展示。统计文件包括文件数量、代码量、提交量、作者信息、每天活跃度、每周活跃度、每月活跃度以及提交数排名等等,信息比较丰富。
安装
gitstats 依赖 Git 、Python2 以及Gnuplot。
以下是最新的依赖版本。
- Python (>= 2.6.0)
- Git (>= 1.5.2.4)
- Gnuplot (>= 4.0.0)
1. gitstats
可以从https://github.com/hoxu/gitstats下载gitstats ,或者用https://github.com/hoxu/gitstats.git在git中拉取。值得一提的是,在win下使用,要把gitstats工程里的gitstats文件重命名成gitstats.py。
2. Python2
由于只支持Python2,可以到https://www.python.org/downloads/release/python-2713/,获取python2的win下的安装包。
安装完以后需要配置环境变量,例如安装在C:\Python27 ,则在环境变量path中增加C:\Python27。
为了避免多个python冲突,把python安装目录下的python.exe修改为python2.exe。
也可以使用conda创建虚拟环境
3. Gnuplot
可以到https://sourceforge.net/projects/gnuplot/files/gnuplot/5.0.6/下载5.0.6版本,选择win版本即可。
安装完毕后,根据README-Windows.txt里描述,需要配置环境变量,配置到安装目录的bin下,例如D:\gnuplot\bin,同样的,在环境变量path中增加。
配置完成后,可以在cmd中输入gnuplot验证。
使用
在cmd中使用python执行gitstats中的gitstats.py。
命令如下:python2 [gitstats.py路径] [git库路径] [输出结果路径]
eg:
python2 E:\git\gitstats\gitstats.py E:\git\myTestGit E:\git\git_result
然后等待窗口执行完毕,在输出结果路径里找index.html,打开即可查看详细输出结果。
如果错误,可以使用以下方式:
1.进入到git的bin目录,运行sh.exe,执行 cd ...,退到根目录。打开目录中的cmd
2.在控制台中进入到需要统计的git项目目录,执行
python 目录/gitstats.py . stats
stats目录生成后,打开其中的index.html
python gitstats.py F:\WORK\PSCLOUD\pscloud E:\gitstats\result
============================================================================================================================