mercurial-all-dirs 1.1.4

1 Example

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

and even:

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

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

2 Failure handling

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.

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.

In both cases whole command returns exit status signalling an error.

3 Installation

pip install --user mercurial_all_dirs

sudo pip install mercurial_all_dirs

[extensions]
mercurial_all_dirs =

pip install --user --upgrade mercurial_all_dirs

pip install mercurial_all_dirs

[extensions]
mercurial_all_dirs = C:/Python27/Lib/site-packages/mercurial_all_dirs.py
;; Or wherever pip installed it

pip --upgrade mercurial_all_dirs

cd c:\hgplugins
hg clone https://foss.heptapod.net/mercurial/mercurial-extension_utils/
hg clone https://foss.heptapod.net/mercurial/mercurial-all_dirs/

[extensions]
mercurial_all_dirs = C:/hgplugins/mercurial-all_dirs/mercurial_all_dirs.py
;; Or wherever you cloned

4 Related extensions

There are a few extensions which support operations on repository groups - Subrepos Extension, OnSub Extension, Forest Extension. They all require using parent repository, which defines the project structure. So, to pull all repos below ~/src you must hg init src, create file like .hgsub there, etc.

All Dirs does not require such a parent repo. It just works on whatever is found on the disk. You decided to keep some repositories below ~/src? Fine, you can hg alld status them all.

Command syntax also matters. I strongly prefer typing:

hg alld pull --update

to typing:

hg onsub "hg pull --update"

At the same time, All Dirs does not support any kind of declaration that some repositories are related, group cloning, version relationship etc. If you are interested in such features, consider Subrepos Extension.

5 History

See HISTORY.rst

6 Repository, bug reports, enhancement suggestions

Development is tracked on HeptaPod, see https://foss.heptapod.net/mercurial/mercurial-all_dirs/

Use issue tracker there for bug reports and enhancement suggestions.

Thanks to Octobus and Clever Cloud for hosting this service.

7 Tests

Tests can be run by:

cram -v tests/*.t

(against current mercurial) or:

tox

(against various versions).

8 Additional notes

Information about this extension is also available on Mercurial Wiki: http://mercurial.selenic.com/wiki/AllDirsExtension

Check also other Mercurial extensions I wrote.