Diff for "OnsubExtension"

Differences between revisions 10 and 11

onsub

This extension is not distributed with Mercurial.

Current Maintainer: Lantiq

The onsub extension will traverse all subrepositories and execute a command in each.

This can be used to update all subrepositories with one command:

$ hg onsub "hg pull -u"

The extension provides a number of environment variables for you to use in your commands:

HG_REPO: Absolute path to the top-level repository in which the onsub command was executed.
HG_SUBPATH: Relative path to the current subrepository from the top-level repository.
HG_SUBURL: URL for the current subrepository as specified in the containing repository's .hgsub file.
HG_SUBSTATE: State of the current subrepository as specified in the containing repository's .hgsubstate file.
HG_SUBTYPE: Type of the current subrepository (hg, git, svn).

You can also easily run commands on all subrepositories of a given type. For instance, to pull all git subrepositories:

$ hg onsub -t git "git pull origin master"

Consult hg help onsub after enabling the extension for the full and up-to-date documentation.

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
onsub = path/to/onsub/onsub.py

-  ⇤ ← Revision 10 as of 2013-09-04 16:27:35 → 
  Size: 1232
  Editor: mpm
  Comment:
+   ← Revision 11 as of 2014-12-26 19:09:13 → ⇥
  Size: 1491
  Editor: LudovicChabant
  Comment: Add info on "-t" option and "HG_SUBTYPE" variable.
-Deletions are marked like this.
+Additions are marked like this.
 Line 30:
+ * `HG_SUBTYPE`: Type of the current subrepository (``hg``, ``git``, ``svn``).

You can also easily run commands on all subrepositories of a given type. For instance, to pull all git subrepositories:
{{{
$ hg onsub -t git "git pull origin master"
}}}