Main Page

From StatSVN


[edit]

The wiki is moving!

This wiki is currently hosted on a residential DSL connection in Canada, and the DSL provider (295.ca, very much not recommended) has been frustratingly unreliable, and their tech support sucks.

The new wiki is at http://wiki.statsvn.org

[edit]

StatSVN

StatSVN retrieves information from a Subversion repository and generates various tables and charts describing the project development, e.g. timeline for the lines of code, contribution of each developer etc. The current version of StatSVN generates a static suite of HTML or XDOC documents containing tables and chart images.

StatSVN is open source software, released under the terms of the LGPL, based on StatCVS.

[edit]

Download

[edit]

Documentation

[edit]

Sample Reports

[edit]

About

[edit]

Features

[edit]

Inherited from StatCVS

  • Lines of code (LOC) metrics per commit, author, directory, and file.
  • Commit history
  • LOC evolution graph, activity by date and time of day
  • Web repository integration (ViewVC and Chora)
  • Apache Ant task
  • Bugzilla integration (developed by StatSvn)
  • XDOC generation (developed by StatSvn)
[edit]

New

  • Query server to obtain lines of code changed/added, per file, per commit
  • Persistence of LOC added/removed
  • Works with multiple branches
  • Support for copy/renames
[edit]

Future

  • Web repository integration: WebSVN
  • Support for tags
  • Improved efficiency
[edit]

Feedback and Discussion

We welcome your comments and contributions!

[edit]

Related Projects

  • StatCVS is StatSVN's parent; generates statistics from CVS instead of Subversion repositories.
  • Stat-SCM is a Maven 2 plugin that uses StatSvn XDOC generation.
  • StatCVS-XML is a fork of StatCVS that generates XML instead of HTML reports.
  • StatCVS Maven Plugin provides StatCVS reports for the Maven project automation software and is based on StatCVS-XML.


[edit]

Quick Start

First, download StatSVN.

Check out a working copy of your project from Subversion. You need the SVN command line client, version 1.3 or higher. Typically, the command looks like this:

svn co svn://server/repo/trunk/modulename

Create a Subversion log file:

svn log -v --xml > logfile.log

Run StatSVN:

java -jar /path/to/statsvn.jar /path/to/module/logfile.log 
/path/to/module

This command creates the HTML reports in the current directory.

More details are available from the User Manual. It also has all the options for customizing the reports. An important note for users of StatSVN: StatSVN needs to have access to the Subversion server.

StatSVN uses JFreeChart, that needs a X server available somewhere. However if you don't want to run a real X server, it is still possible to use X Virtual Framebuffer, akaXvfb. See this page for more information about this issue. This requirement does not apply when running in Windows.

If you run into problems, consider asking for help on the StatSVN users mailing list.

[edit]

Quick Links
Retrieved from "http://svn.statsvn.org/statsvnwiki/index.php/Main_Page"