Guestrepo Extension

Extension for enterprises needing to handle modules and components

1. Status

This extension is not distributed with Mercurial.

Maintainer: Paul Nathan at


Mailing List (defunct):

2. Overview

The Guestrepo Extension adds commands to clone, push, pull, and summarize the state of nested repositories.

Use case:

  • Many products, multiple projects within those products, multiple developers within those projects, multiple branches per developer
  • Source code shared in a multiplicity of configurations
  • Third party code (possibly patched on some branches)
  • A given module may have multiple versions going into the same product

Hg subrepos do not handle the sharing of components well, due to the recursive merge from the top (super) repo and requirement to lock at a specific version.

Guestrepo supports python version 2.4 and above and mercurial 1.9 and above.

3. Configuration

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

guestrepo = path/to/guestrepo/guestrepo

4. See also

ForestExtension HgNestedExtension


GuestrepoExtension (last edited 2016-07-24 18:03:50 by paulnathan)