Skip to main content

Mercurial All Dirs Extension

Project description

Execute the same Mercurial command in many repositories.

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" src/

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

3.1 Linux/Unix (from PyPI)

If you have working pip or easy_install:

pip install --user mercurial_all_dirs

or maybe:

sudo pip install mercurial_all_dirs

(or use easy_install instead of pip). Then activate by:

mercurial_all_dirs =

To upgrade, repeat the same command with --upgrade option, for example:

pip install --user --upgrade mercurial_all_dirs

3.2 Linux/Unix (from source)

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
    hg clone
  • update to newest tags,

  • activate by:

    mercurial_all_dirs = ~/sources/mercurial-all_dirs/

To upgrade, pull and update.

See mercurial_extension_utils for longer description of this kind of installation.

3.3 Windows

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:

mercurial_all_dirs = C:/Python27/Lib/site-packages/
;; 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
hg clone

update to tagged versions and activate by path:

mercurial_all_dirs = C:/hgplugins/mercurial-all_dirs/
;; Or wherever you cloned

See mercurial_extension_utils documentation for more details on Windows installation.

5 History


6 Repository, bug reports, enhancement suggestions

Development is tracked on HeptaPod, see

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:


(against various versions).

8 Additional notes

Information about this extension is also available on Mercurial Wiki:

Check also other Mercurial extensions I wrote.

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_all_dirs-1.1.3.tar.gz (14.2 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