#pragma section-numbers 2
= Guestrepo Extension =

Extension for enterprises needing to handle modules and components

<<TableOfContents>>

== Status ==

'''This extension is not distributed with Mercurial.'''

''Maintainer: '' ''Paul Nathan at https://bitbucket.org/guestrepo/guestrepo''

Repository: ''https://bitbucket.org/guestrepo/guestrepo'

Mailing List (defunct): ''http://lists.logilab.org/mailman/listinfo/mercurial-guestrepo''

== 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.

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

{{{
[extensions]
guestrepo = path/to/guestrepo/guestrepo
}}}

== See also ==

ForestExtension
HgNestedExtension

----
CategoryExtensionsByOthers