hgsubversion Extension
This extension is not distributed with Mercurial.
Author: Augie Fackler and co.
Download site: http://bitbucket.org/durin42/hgsubversion/overview/
Additional information:
http://blog.red-bean.com/sussman/?p=116 (early notes and installation instructions)
Overview
hgsubversion is an extension for Mercurial that allows using Mercurial as a Subversion client. See also WorkingWithSubversion.
Use
Most commands wrap their native equivalent. This is true for clone, outgoing, pull, and push . parents grows a --svn flag that shows the svn parent of a change, provided there are no merges between the current revision and the svn parent. Also, diff gets a --svn flag that changes the default "old" rev to the svn parent revision, and formats the diff to be almost identical to those produced by svn diff, making it suitable for tools that rely on that format.
Cloning a repository
Right now, you can only clone repositories that use a more-or-less standard Subversion layout. That is, the default location where work is done is called trunk, branches are located in a sibling of that directory called branches. Tags are expected to be another sibling of trunk called tags, but that is configurable.
To get a clone of the Nose project, start with:
$ hg clone svn+http://python-nose.googlecode.com/svn nose-hg
The last argument, nose-hg is not strictly required, but because of how Google Code lays out projects, the default target would be named svn-hg which is not very helpful.
Pulling New Updates
This will replay all the revisions from the Subversion repository into a new Mercurial repository. If nose-hg already exists, it will try to use that as a repository previously created with the same command.
This is analogous to a normal hg pull except that it will pull from the Subversion server instead of from a Mercurial one, and you can only pull incoming revisions in order. That is, you can't decide to pull just trunk changes, you have to get all of them..
If there are new revisions, and you have new revisions in your local hg repository, this will create a new head. The important point to note is that hgsubversion cannot push merge changesets to a svn repository. This means you should not try to merge this new head -- if you do so, hg push to svn will fail. Instead, you should rebase the changesets that you want to push to the Subversion repository (see Rebasing changes below).
Other Stuff
You can use the usual Mercurial commands to work with this repository.
Rebasing changes
If you have a series of commits on a given branch, and want to move them to the tip of that branch, use the following command
hg rebase --svn
while on the tip of your work, and those changesets will automatically be rebased over top of the new upstream work.
Pushing changes back to subversion
You can see what changes need to be sent back to the server using
hg outgoing
, and you can push the local changes back to the subversion server using
hg push
Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] rebase= svn=/path/to/hgsubversion