Differences between revisions 75 and 76
Revision 75 as of 2013-01-21 23:49:19
Size: 7419
Editor: rcl
Revision 76 as of 2013-08-26 19:48:56
Size: 289
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
= Converting Repositories =
Your first option should probably be the ConvertExtension bundled with Mercurial. It supports branches, incremental imports, and a few other nice features, and is maintained by the Mercurial authors. It currently only understands CVS, Subversion, Git, Darcs, Monotone, Bazaar, GNU Arch, Perforce and Mercurial as source formats and Mercurial and Subversion as destination formats.

Otherwise, the following tools may be useful.


== Arch / TLA / Baz 1.5 ==
 * The ConvertExtension supports GNU Arch since (df659eb23360, 0.9.5+)
 * Other tools for Arch conversion can be found at ArchConversion.

== Bazaar? ==
 * ConvertExtension
 * [[Tailor]] - a generic conversion tool.

== ClearCase ==
 * ClearCaseConversion - some ideas

== RCS ==
Convert to CVS (see [[ConvertExtension#Converting_from_RCS.29|ConvertExtension#Converting_from_RCS)]] and then use CVS tools.

== CVS ==
Multiple convertors exist for converting from CVS to Mercurial:

 * ConvertExtension - the convert extension supports simple CVS repositories
 * [[http://hg.gerg.ca/cvs2svn|cvs2hg]] is a branch of cvs2svn with native Mercurial output.
 * [[Tailor]] - a generic conversion tool
 * [[fromcvs]] - a fast, incremental CVS to Mercurial converter
 * [[http://hg.beekhof.net/hg/cvs-import|hg-cvs-import]] - InstructionsforHgcvsimport

'''Note''': Mercurial's ConvertExtension uses a naive algorithm to understand CVS. If your CVS repository contains no tags and no branches, it'll work just fine. If you, and everyone who has ever used your CVS repository, have always tagged/branched the tip of your entire source tree, it should work just fine. But if you have ever played any funny games with tagging or branching, ConvertExtension will not work. It doesn't even try to handle those cases because it is based on cvs2ps, which doesn't even try to understand the full range of strange things people do with CVS tags/branches. The only tool known to handle all of CVS' weird corner cases is cvs2svn. Luckily, there is now a version of cvs2svn with a native Mercurial backend called cvs2hg. See [[http://hg.gerg.ca/cvs2svn/raw-file/tip/README.cvs2hg|its README.cvs2hg file]] for more information. However cvs2hg may generate 'fixup commits' that violate the invariant that [[http://www.selenic.com/hg/rev/1792b8a9422b|parents of a merge changeset shall not be linearly related]]. This means that subsequent operations on the converted repository will [[http://mercurial.selenic.com/bts/issue2538|silently fail]].

In the past, other options have included:

 * use cvs2svn to convert to Subversion, then ConvertExtension to import the Subversion repository.
 * use cvs2git to convert to git fast-import format, then use FastImportExtension to import that.

You can also convert from Mercurial to CVS:

 * CvscommitExtension - (need info)

== Darcs ==
 * The ConvertExtension supports Darcs.
 * An older sample Darcs conversion script is available in the contrib/ directory of the Mercurial source.
 * Also see [[Tailor]].

== Git ==
See GitConversion (incremental).

== Subversion ==
The ConvertExtension included in Mercurial 0.9.5 can import Subversion trees. It uses the Subversion API, so it can speak any Subversion repository access protocol. It's a good idea to work against a local copy of the Subversion repository you want to convert. Make a local copy of your svn repo using [[http://svnbook.red-bean.com/en/1.5/svn.ref.svnsync.html|svnsync]].

Examples and details about Subversion interoperability can be found in WorkingWithSubversion.

Converters that work on local repositories or data (faster, if this is an option for you):

 * http://hg.omnifarious.org/~hopper/svn2hg - requires python2.5 and is very rough, lacking in documentation or any UI niceties at all to speak of.

Converters that work on remote repositories:

 * http://ajayu.memi.umss.edu.bo/viborita/weblog/svn2hg.py-convertir-repositorio-subversion-mercurial - simple script that downloads every rev info from svn server. Works on subdirectories of the repo. Handles branches, tags, etc. inefficiently (does not tell hg that they are different from any other diff). Requires pysvn, Mercurial source. Use the download link, not copy&paste.
 * http://dingoskidneys.com/cgi-bin/hgwebdir.cgi/queue-convert-svn/ - Patch queue against Mercurial. Patches create a convert-repo hacked to support SVN as a source. Uses the SVN API, not SVN command line + subprocess.

Syncing tools:

 * [[http://cheeseshop.python.org/pypi/hgsvn|hgsvn]] allows you to work on SVN checkouts using Mercurial (mirroring all SVN history in a local Mercurial repository on which you can also do local development). It is useful for managing private branches, submitting patches to project maintainers, have fast local operations instead of slow remote "svn up/log/blame", etc. Also useful as "one-shot" conversion tool if you just remove all the svn directories ("find . -name '.svn' |xargs rm -r") afterwards.
 * SubversionToMercurialSync (like hgsvn, but more primitive)
 * The HgSubversion Mercurial extension. Read about it in its own page on this wiki.

== Perforce ==
The ConvertExtension supports conversion from Perforce since version 1.2.

The [[PerfarceExtension|Perfarce extension]] allows you to pull changelists from Perforce, and to push Mercurial changesets back to it.

There is also a stand-alone script [[http://hg.omnifarious.org/~hopper/p4_to_hg|p4_to_hg]] This utility can actually keep two repositories in sync.

Currently, it's slapped together and built to serve my particular needs, but it could probably be modified into something more general. It currently makes no attempt to do anything with Perforce's ability to track branches or the movement of changesets from branch to branch. But it hasn't received any love since 2007 or so, and I don't have access to a Perforce repository to use anymore, so I'm not doing any development on it. The other options are probably better. -- EricHopper 2010-10-29 10:29

See also posting http://selenic.com/pipermail/mercurial/2008-July/020241.html: "Start of Mercurial git-fast-import importer (was p4 to hg)" by Paul Crowley

See also posting http://unixsadm.blogspot.com/2010/07/converting-perforce-depots-to-mercurial.html: "Converting Perfoce depots to Mercurial" by Criveti Mihai

== Bitkeeper ==
Because of the threatening behavior of Larry !McVoldemort of Bitmover, no Bitkeeper conversion tools have been made publicly available. See GenericConversion for details on building your own repository conversion tool.

== TeamWare ==
Very experimental conversion script available if you can find nothing better:


== Visual SourceSafe ==
 * SourceSafeConversion - A script to convert a [[WikiPedia:Visual_SourceSafe|Visual SourceSafe]] project to a Mercurial Repository

== Monotone ==
 * ConvertExtension

== Team Foundation Server (TFS) ==
 * http://blog.dabide.no/idabide/2010/10/18/converting-from-tfs-to-mercurial/

== Other systems ==
[[Tailor]] is a conversion tool that can do simple conversions from a variety of systems. See GenericConversion for details on building your own repository conversion tool.

Santa Clara-born and raised Charlsie Holmes is hooked on [[http://www.sexualitystudies.net/group/find-out-what-you-need-know-about-travel/thread/68615|Costa Blanca Spain weather July,]] rc planes and saltwater aquariums. Last of all, she's fascinated by playing with her awesome friends.

Santa Clara-born and raised Charlsie Holmes is hooked on Costa Blanca Spain weather July, rc planes and saltwater aquariums. Last of all, she's fascinated by playing with her awesome friends.

RepositoryConversion (last edited 2020-07-05 13:34:51 by MarcinKasperski)