git

Operate on Git repositories.

1. Status

This extension is distributed with Mercurial asexperimental.

Author:Augie Fackler

2. Overview

This extension grants Mercurial the ability to operate on Git repositories.

Requires pygit2.

3. Usage

3.1. Installation

Install pygit2 into the Python used by your Mercurial:$(hg debuginstall -T'{pythonexe}') -m pip install --user pygit2

3.2. Configuration

Enable the extension:

[extensions]git =

3.3. Use

In the Mercurial 5.4 release:

• git(1) must be used for all network operations (e.g. clone, push, pull, incoming, outgoing).

• Only local branches are presented in Hg (as bookmarks). Usegit branch -t remotes/origin/branchname to see more upstream branches as bookmarks.

• Repositories with octopus merges are not supported.
• Shallow clones probably don't work.

Example:

git clone git://...hg init --githg statushg loghg bookmarkshg diffhg addhg commitgit pushgit pull...

4. Alternatives

4.1. HgGit

TheHgGit extension, which is installed separately from Mercurial, is more mature and more widely used.

It converts a git repository into a native Mercurial repository (including incremental imports). As a consequence:

• each commit has a Mercurial hash and a separate Git hash (accessible using the "gitnode" revset/template keyword).
• the converted repository is roughly twice as large.

4.2. Convert

TheConvertExtension, packaged with Mercurial, has Git support.