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/
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:
(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.
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.