hg churn

histogram of changes to the repository

hg churn [-d DATE] [-r REV] [--aliases FILE] [FILE]

This command is provided by the churn extension.

This command will display a histogram representing the number of changed lines or revisions, grouped according to the given template. The default template will group changes by author. The --dateformat option may be used to group the results by date instead.

Statistics are based on the number of changed lines, or alternatively the number of matching revisions if the --changesets option is specified.

Examples:

# display count of changed lines for every committer
hg churn -T "{author|email}"

# display daily activity graph
hg churn -f "%H" -s -c

# display activity of developers by month
hg churn -f "%Y-%m" -s -c

# display count of lines changed in every year
hg churn -f "%Y" -s

# display count of lines changed in a time range
hg churn -d "2020-04 to 2020-09"

It is possible to map alternate email addresses to a main address by providing a file using the following format:

<alias email> = <actual email>

Such a file may be specified with the --aliases option, otherwise a .hgchurn file will be looked for in the working directory root. Aliases will be split from the rightmost "=".

Options

Every command accepts the global options.

-r	--rev REV [+]	count rate for the specified revision or revset
-d	--date DATE	count rate for revisions matching date spec
-T	--template TEMPLATE	template to group changesets (default: {author|email})
-f	--dateformat FORMAT	strftime-compatible format for grouping by date
-c	--changesets	count rate by number of changesets
-s	--sort	sort by key (default: sort by count)
	--diffstat	display added/removed lines separately
	--aliases FILE	file with email aliases
-I	--include PATTERN [+]	include names matching the given patterns
-X	--exclude PATTERN [+]	exclude names matching the given patterns
	--mq	operate on patch repository

Options marked [+] can be repeated.