Help: churn

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

histogram of changes to the repository

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 ([+] can be repeated):

-r	--rev REV [+]	count rate for the specified revision or revset
-d	--date DATE	count rate for revisions matching date spec
-t	--oldtemplate TEMPLATE	template to group changesets (DEPRECATED)
-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

global options ([+] can be repeated):

-R	--repository REPO	repository root directory or name of overlay bundle file
	--cwd DIR	change working directory
-y	--noninteractive	do not prompt, automatically pick the first choice for all prompts
-q	--quiet	suppress output
-v	--verbose	enable additional output
	--color TYPE	when to colorize (boolean, always, auto, never, or debug)
	--config CONFIG [+]	set/override config option (use 'section.name=value')
	--config-file HGRC [+]	load config file to set/override config options
	--debug	enable debugging output
	--debugger	start debugger
	--encoding ENCODE	set the charset encoding (default: UTF-8)
	--encodingmode MODE	set the charset encoding mode (default: strict)
	--traceback	always print a traceback on exception
	--time	time how long the command takes
	--profile	print command execution profile
	--version	output version information and exit
-h	--help	display help and exit
	--hidden	consider hidden changesets
	--pager TYPE	when to paginate (boolean, always, auto, or never) (default: auto)

Mercurial > hg > aoc

Help: churn