Skip to main content

Mercurial Dynamic Username Extension

Project description

Use different commit username per directory tree.

With this extension you may commit as John Smith <> in trees below ~/work, and as Johny <> in code lying in ~/hobby - and set this rule once, in ~/.hgrc.


Install the extension (pip install mercurial_dynamic_username or manually in the way described below).

Write in your ~/.hgrc:

dynamic_username =

work.location = ~/work
work.username = John Smith <>
hobby.location = ~/hobby ~/blogging
hobby.username = Johny <>

and just commit. In any repository lying below ~/work you will commit as John Smith, in repos below ~/hobby as Johny, elsewhere default setting (username from [ui]) will be used.

Configuration syntax

All settings are defined in [dynamic_username] section, and have the following form:

«somelabel».location = «list of directory names»
«somelabel».username = «username used there»

Labels are used only to join those two settings in pairs.

Directory names specified in location are space or colon separated (using standard Mercurial ways of parsing lists in the config). Repository match the rule if it lies within directory tree(s) specified here. Tildas (~/.. and ~john/...) are expanded.

Usernames have the same syntax as standard username.

Specifying location without username asks extension to revert to standard username, for example:

username = Jake <>

work.location = ~/work
work.username = John Smith <>
open.location = ~/work/open-source

will commit as John Smith in ~/work/libs/veryimportant, but will revert to default Jake in ~/work/open-source/libshared.

Match priority

If more than one location matches repository, longest one is used (like in the open-source example above). Longest is selected using actual canonical path after tilda expansion (~/work/sth is longer than /home/littlejohny/work).

Dynamic usernames currently always win against [ui]-section username, even if the latter is defined in per-repository .hg/hgrc. I would gladly give priority to the latter, but I have no idea how to detect that without re-parsing configuration.

Testing configuration effects

You can test effects by callling:

hg showconfig ui.username

(results should vary depending on the repository).


Recommended way:

pip install mercurial_dynamic_username

(prepend with sudo if necessary).

Manual way:

  • install mercurial_extension_utils

  • download from this repository and save it somewhere

  • activate extension by:

    dynamic_username = /path/to/



Internal refactoring, requires mercurial_extension_utils.


First public release.

Development, bug reports, enhancement suggestions

Development is tracked on BitBucket, see

Use BitBucket issue tracker for bug reports and enhancement suggestions.

Additional notes

Information about this extension is also available on Mercurial Wiki:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mercurial_dynamic_username-0.7.0.tar.gz (5.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page