This is an extension for the mercurial source control management, which creates an image file displaying the activity of a repository. The activity is a rough estimates of when has the developement happened ?

hgactivity can use either the number of commits, or the number of lines modified/removed/added.

As an example, here is the activity for the different commiters (only the top 5 are displayed in the legend) on the mercurial repository itself :

And another one with the global activity for the repository:

You can find a lot of other images on the gallery

Where to get it ?

Grag the last official release from the files tab at the top of the page

If you want to use the very latest source (less tested, but quite probably safe enough to use), you can either clone it using:

hg clone http://sources.freehackers.org/Hgactivity/

or grab a tarball (zip, bz2, tar.gz, ...) of the latest source at the top of the mercurial page : http://sources.freehackers.org/Hgactivity/

Installation

Be sure to have matplotlib installed, check your distribution tools for this.
Then you need to extract the source somewhere (in my setup i use ~/hg/hgactivity/) and to tell mercurial about it, by adding a line like this one to ~/.hgrc, in the [extensions] section:

[extensions]
activity=/home/orzel/hg/hgactivity/activity

(use your actual path to the file, of course)

Windows user can refer to this blog entry

Usage and documentation

Quick version : go to some mercurial repository, and type hg activity --mode=gui.

You might want to read hg activity --help for more information. For less basic usage, there's a page dedicated to documentation.

Compatibility

It is always tested with the latest mercurial version (currently 2.0.x). It probably works with most 1.x versions.
I’m a big fan of this kind of information, and I’m sure to use this extension regularly, so you can count on it being maintained.

mercurial.global.png (50.9 KB) Thomas Capricelli, 06/15/2009 01:59 AM

mercurial.png (125 KB) Thomas Capricelli, 06/15/2009 02:01 AM