#pragma section-numbers 2
= Activity extension =
Try to show how much activity happened on the repository over time.

<<TableOfContents>>

== Status ==
'''This extension is not distributed with Mercurial.'''

''Author: '' [[https://freehackers.org/thomas|Thomas Capricelli]]

Web page and repository: https://freehackers.org/orzel/hgactivity

== Overview ==
This extension creates an image file displaying the activity of a repository. The activity is a rough estimates to answer the question : "when did the developement happened ?"

As an example, here is the activity for the mercurial repository itself :

{{attachment:activity-hg-general.png}}

The same, but split by author:

{{attachment:activity-hg-byauthors.png}}

Zoom in on recent history + displaying tags::

{{attachment:activity-hg-recentandtags.png}}

The extension can be used on desktop (displaying the image) or on server (headless, creating the image file).

There are quite some options to change the display, setting the date range, exluding some revs and such. You can of course use the usual --help approach, but you can also play with the gui : when you change options, the corresponding CLI command is displayed for your convenience. The typical use is to configure what you want on your desktop using the mouse, and then copy/paste the command line on your server cron or whatever.

All of this is explained on the [[https://freehackers.org/orzel/hgactivity|web page]]

== Configuration ==
Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
activity=/path/to/hgactivity/activity
}}}
(with the actual path to the extension, of course)

----
CategoryExtensionsByOthers CategoryExtensionsByOthers