Mercurial All Dirs Extension
Imagine you have Mercurial repositories in ~/src/libs/acme, ~/src/libs/net/aaa, and ~/src/libs/net/bbb. Then:
cd ~/src/libs hg alldirs status # … shows status in all three repos hg alldirs heads -t # … and heads hg alldirs log -l 2 # … and recent commit
hg alldirs commit -m "Documentation updates" # Commit in all three repos hg alldirs push bb # … and pushes them all
Relative file names are resolved against given repo root (the command chdirs to every repo before actually executing it):
hg alldirs commit -m "Version update" setup.py src/version.py
In practice I usually shortcut the command and type:
hg alld status # etc
Note that alldirs does not require any kind of parent repository.
In case you are already inside some repo, command is executed on it, so alld does not matter:
cd ~/src/libs/net/aaa hg status hg alld status # … Both do the same
In case given command is not known (hg alldirs badcommand), or got invalid options (hg alldirs log -s), error is reported immediately and processing stops.
Technically: command name and params are parsed once, before visiting subdirs.
In case given commands fails during execution (hg alldirs pull nosuchalias), alldirs executes the command in every repo (doesn’t stop). After finishing the job, it summarizes list of repositories in which the command failed.
That is done on purpose, I do not want my hg alld pull to break if some repo lacks default path.
In both cases whole command returns exit status signalling an error.
If you have working pip or easy_install:
pip install --user mercurial_all_dirs
sudo pip install mercurial_all_dirs
(or use easy_install instead of pip). Then activate by:
[extensions] mercurial_all_dirs =
To upgrade, repeat the same command with --upgrade option, for example:
pip install --user --upgrade mercurial_all_dirs
If you don’t have pip, or wish to follow development more closely:
clone both this repository and mercurial_extension_utils and put them in the same directory, for example:
cd ~/sources hg clone https://bitbucket.org/Mekk/mercurial-extension_utils/ hg clone https://bitbucket.org/Mekk/mercurial-all_dirs/
update to newest tags,
[extensions] mercurial_all_dirs = ~/sources/mercurial-all_dirs/mercurial_all_dirs.py
To upgrade, pull and update.
See mercurial_extension_utils for longer description of this kind of installation.
If you have any Python installed, you may install with pip:
pip install mercurial_all_dirs
Still, as Mercurial (whether taken from TortoiseHg, or own package) uses it’s own bundled Python, you must activate by specifying the path:
[extensions] mercurial_all_dirs = C:/Python27/Lib/site-packages/mercurial_all_dirs.py ;; Or wherever pip installed it
To upgrade to new version:
pip --upgrade mercurial_all_dirs
If you don’t have any Python, clone repositories:
cd c:\hgplugins hg clone https://bitbucket.org/Mekk/mercurial-extension_utils/ hg clone https://bitbucket.org/Mekk/mercurial-all_dirs/
update to tagged versions and activate by path:
[extensions] mercurial_all_dirs = C:/hgplugins/mercurial-all_dirs/mercurial_all_dirs.py ;; Or wherever you cloned
See mercurial_extension_utils documentation for more details on Windows installation.
Development is tracked on BitBucket, see http://bitbucket.org/Mekk/mercurial-all_dirs/
Use BitBucket issue tracker for bug reports and enhancement suggestions.
Information about this extension is also available on Mercurial Wiki: http://mercurial.selenic.com/wiki/AllDirsExtension
Check also other Mercurial extensions I wrote.