svn代码量统计工具StatSVN的使用

一、使用前准备

需要安装svn命令行工具Subversion（现在安装包Setup-Subversion-1.8.9-1.msi直接安装即可）或者svn客户端（TortoiseSVN）和下载StatSVN包，现在地址sourceforge.net/projects/statsvn/

 

二、使用

解压压缩包，到一个目录，如c:\statsvn；

checkout 工作目录

从SVN服务器上checkout最新版本的项目文件，使用CMD首先导向到路径，c:\statsvn，然后运行命令：svn co https://172.23.1.80/svn/bookAirWorkspace/project/bookAir，这样项目的最新版本就load到c:\statsvn的目录下面；

生成log文件

导出SVN日志文件svn.log，使用命令：svn log  -v --xml C:\statsvn\bookAir > C:\statsvn\bookAir\svn.log；

使用StatSVN统计SVN中的代码量

运行StatSVN统计数据，命令：java -jar statsvn.jar C:\statsvn\bookAir\svn.log C:\statsvn\bookAir，当前CMD的工作路径还是c:\statsvn；

复杂统计指令：

java -jar statsvn.jar C:\statsvn\bookAir\svn.log C:\statsvn\bookAir -include **/*.java:**/*.jsp:**/*.js:**/*.css:**/*.xml 

-exclude **/js/jquery-1.6.2.min.js

查看统计结果

等待一段时间，C:\statsvn目录下就会生成大量的统计文件，打开index.html即可进行查看。

 

三、高级使用

新建bat文件，statSVN.bat，内容为

 

svn log -v --xml -r {2016-12-19}:{2016-10-09} > svn.log
java -jar statsvn.jar svn.log ./ -charset gbk -output-dir ./report

 

 

svn log -v --xml -r {2010-12-01}:{2011-01-01} > svn.log java -jar statsvn.jar svn.log ./ -output-dir ./report

使用说明：

（1）将statsvn.jar和statSVN.bat这两个文件拷贝到要统计的chechout的目录下，例如D:/source_rep目录是存放svn检出的代码的路径。

       d:/source_rep

                 |

                 ----- .svn

                 |

                 ----- statSVN.bat

                 |

                 ----- statsvn.jar

（2）运行  statSVN.bat， 在d:/source_rep目录下生成是 svn.log文件和report目录

   

       d:/source_rep

                 |

                 ----- .svn

                 |

                 ----- statSVN.bat

                 |

                 ----- statsvn.jar

                 |

                 ----- svn.log

                 |

                 ----- report

                             |

                             ---- index.html

（3）{2010-12-01}:{2011-01-01} 显示了要统计代码的时间段。

        注意在报告中显示的时间段是：

        Report Period:

                  2010-12-02 to2010-12-31

       参数中使用的均是开区间。(注：试了下按照日期倒置利用上面的脚本显示代码量时正确的，如svn log -v --xml -r {2016-05-20}:{2016-04-10} > svn.log )  而用前置则统计的不准确，不知道为什么

Author	Lines of Code
honghailiang	8292 (49.6%)

 

（4） 使用IE浏览器，打开report/index.html，就可以查看统计代码开发情况了。



 

四、StatSVN优缺点分析

优点

StatSVN会把当前SVN库的状态用图片和图表的方式展现出来，可以按不同分类分别展开，功能强大。

缺点

StatSVN统计的是所有代码行，包括注释和空行，但一般度量要求是有效代码行，在分析时需要注意这一点。

StatSVN不考虑修改的代码行数，只考虑与上一版本相比新增(+)与删除(-)的代码行数。

 

五、遇到的问题

例如：用svn co http://xxxxxxxxxxx:xxxxx/svn/xxxx 下载代码后，会生成一个目录xxx其中包含了工程代码，如果直接在xxx下执行statSVN.bat(statsvn.jar中用到了svn diff命令)文件或者执行svn diff命令，会报如下错误

这个时候也能才生报告，但是修改代码的行数统计不到（比如我只是对某个文件代码做了修改，就是update操作，就统计不到），而只能统计出新增代码文件的代码行数。

而在下一级目录，比如src目录下执行statSVN.bat文件或者svn diff命令，就不会报错，报告中会包含修改代码的行数（同样不知道为什么）。



六、satasvn.jar选项   http://wiki.statsvn.org/User%20Manual.ashx    http://www.statsvn.org/

A list of all options understood by StatSVN follows.

General Options

-output-dir

Specify an output directory. The reports will be generated in this directory. The directory will be created if it doesn't exist.

 

-include
-exclude

Specify filters to exclude files from the analysis. A file will be ignored if it doesn't match any of the patterns ininclude-pattern-list, or if it matches any pattern inexclude-pattern-list.

The patterns are lists of Apache Ant-style wildcard patterns, seperated by colons or semicolons. The wildcards are:

• '?' matches a single character
• '*' matches zero or more characters
• '**' matches zero or more directories

For example, src/**/*.java matches all java files in thesrc directory or its subdirectories. Note that*.java only matches java files in the root directory, because '*' does not match subdirectories.

One more example:

-include "**/*.c:**/*.h" -exclude "legacy/**"

This matches all .c and .h files anywhere in the directory tree except those in thelegacy directory and its subdirectories.

For more information on Ant's wildcard syntax, see thePatternset section of the Ant manual.

If not specified, all files will be included and no files will be excluded.

Note: Unix users must put the patterns in quotes, or the shell will interfere with the wildcards.

 

-cache-dir

 

Specify a cache directory for information retrieved from the Subversion server (e.g. line counts). The data will be saved in this directory. The directory will be created if it doesn't exist. By default, the current user directory is used.

 

-username

Specify a username to use when connecting to the Subversion server.

 

-password

Specify a password to use when connecting to the Subversion server.

 

-tags

Includes information about Subverison tags into the reports. Only tags matching the regular expression are included. To includeall tags, add-tags '.*' to the command line.

Note: Unix users must put the expression in quotes, or the shell will interfere with the wildcards.

Note: Tags are determined by looking at your repository's /tags directory. To be able to use this feature, you must generate the log file from the root of your repository, so that the log contains information from both the /tags and the /trunk. The checked out version does not have to contain the tags directory.

 

-tags-dir

Specifies the root directory from which the tags regular expression is evaluated. The default -tags-dir is/tags/

 

-no-developer

Excludes a Subversion account name from all developer reports. This is useful to reduce noise from administrative and other non-developer accounts. Multiple accounts can be excluded by adding the option to the command line once for each account.

Report Options

-xdoc

Generate Maven XDoc instead of HTML. This allows Maven and Maven 2 to integrate the reports when it generates the projects Maven site. Reports could be placed, for example, intosrc/site/statsvn.

 

-xml

Generate XML instead of HTML.

 

-css

Optional (default varies for html or xdoc). Specify aCascading Style Sheet for the report. This can be a HTTP URL or a local file. A URL will simply be linked in every page of the report. A local file will be copied into the report directory.

 

-notes

The contents of the specified file will be included at the top of the report's index page. The file should contain a valid block-level HTML fragment, for example:

  These are development statistics for the
  StatSVN
  project, created by StatSVN itself.


  Note:
  This report was generated by an unreleased
  development version of StatSVN. It might
  contain features not yet found in the
  official release.

 

-title