threads / discuss / 30196

Migrating SVN to Git, and preserve merge information

Subject: Migrating SVN to Git, and preserve merge information

## tl;dr

5 messages between Apr 10, 2012 and Apr 11, 2012.

replies: 4people: 3as markdown or json

Nick Douma· Apr 10, 2012, 15:18 UTC · lore
Hi,

I currently have two SVN repositories I'm looking to convert to Git. While the process itself isn't all that hard (following this guide[1]), I'm looking to do a bit more than just convert raw commits.

The repositories basically have two main branches at a time, for example:
* trunk
* current version, for example 3.5

Our SVN workflow consisted of working on trunk, and then manually merging single commits from trunk to the other branch. We quite consistently mentioned the merged commits in the SVN commit message, and I'm looking to use this information to generate a more accurate tree in Git. The commit messages are for example:

trunk rev 100: Fixed important bug branch rev 101: Merged r100 from trunk

Or more elaborate:
branch rev 200: Merged r100,r101,r.... from trunk

In these examples, tools like gitk or git log should show a line from rev 100 to rev 101 in the first example, and lines from r100, r101,rn to rev 200 in example two.

I have tried to create a custom grafts file to create the parent-child relations above, and basically finds all merge commits and converts them into graft lines like so:

<merge commit sha hash> <original git parent sha hash> <sha hash of merged rev 1> ... <sha hash of merged rev n>

This all works to a certain extent, but the problem arises when trying to view older history in these repositories. If I use the grafts file, and do `gitk --all`, gitk freezes. Gitg doesn't show commits before a certain point. tig and `git log --graph` all show a huge amount of parentless commits near the bottom. All of this leads me to the conclusion that something is wrong with the method of using grafts, rather than problems in the individual tools.

Can someone find something obvious that I'm missing in the above approach? Or alternatively suggest another more appropriate method of achieving the same results in Git?

Kind regards,
Nick Douma
[1]: http://john.albin.net/git/convert-subversion-to-git
Andrew Sayers· Apr 10, 2012, 22:57 UTC · re: Nick Douma · lore

Re: Migrating SVN to Git, and preserve merge information

Hi Nick,

Would I be right in thinking that a commit like "Merged r100,r101,r102 from trunk" will create three grafts? If so, that might be the problem.

Git differentiates between "merges" (which include every commit up to and including the specified one) and "cherry-picks" (which just include the specified commit), whereas SVN calls both of these "merges". Grafts are a way of creating "merges" rather than "cherry-picks" (which git doesn't have any metadata for), and it's not at all easy to get "merge" data out of SVN in the general case. Having said that, it's often a good enough heuristic to pick the highest revision number mentioned in the commit message and pretend it's a merge.

Incidentally, I'm planning to work on this area of SVN->git conversion in the coming months. I don't have anything you could use yet, but I don't suppose the scripts you used are available somewhere? Getting revision information out of log files is particularly tricky, and everyone stumbles over a different set of issues. I'd be really interested to pick any nuggets of wisdom out of the approach you took.

	- Andrew
Nick Douma· Apr 11, 2012, 07:24 UTC · re: Andrew Sayers · lore

Re: Migrating SVN to Git, and preserve merge information

Hi Andrew,
On 11-04-12 00:57, Andrew Sayers wrote:
> Would I be right in thinking that a commit like "Merged r100,r101,r102
> from trunk" will create three grafts?  If so, that might be the problem.

One SVN 'merge' commit will generate one graft. The graft itself will contain all revisions mentioned in the merge commit, and whatever the original git parent was before the graft.

Show 8 quoted lines
> Git differentiates between "merges" (which include every commit up to
> and including the specified one) and "cherry-picks" (which just include
> the specified commit), whereas SVN calls both of these "merges".  Grafts
> are a way of creating "merges" rather than "cherry-picks" (which git
> doesn't have any metadata for), and it's not at all easy to get "merge"
> data out of SVN in the general case.  Having said that, it's often a
> good enough heuristic to pick the highest revision number mentioned in
> the commit message and pretend it's a merge.

The way we 'merged' in SVN was indeed more like cherry-picking, but I'm looking to display this information as a merge in Git. I also would like to include all revisions if possible.

The real problem I seem to be having is not completely understanding how Git grafts work, because I think I'm hitting some kind of limitation or bug, or just not using it right.

Show 6 quoted lines
> Incidentally, I'm planning to work on this area of SVN->git conversion
> in the coming months.  I don't have anything you could use yet, but I
> don't suppose the scripts you used are available somewhere?  Getting
> revision information out of log files is particularly tricky, and
> everyone stumbles over a different set of issues.  I'd be really
> interested to pick any nuggets of wisdom out of the approach you took.

I don't really have any useful script for you at the moment, but the main approach is this:

* I first tag all SVN Git commits with the original SVN revision, like:
"svn/1234"
* Then I retrieve all commits with "merge" in the message, but not "unmerge"
* Now I filter all revisions from the commit message using a regex or two.
* Using all relevant revisions, I retrieve the corresponding SHA hashes
using the tag names I created in step 1.
* Finally, I write a graft file in format:
<merge commit> <original git parent> <merge rev 1> ... <merge rev n>
Kind regards,
Nick Douma
Santi Béjar· Apr 11, 2012, 11:13 UTC · re: Nick Douma · lore

Re: Migrating SVN to Git, and preserve merge information

On Wed, Apr 11, 2012 at 9:24 AM, Nick Douma <n.douma@nekoconeko.nl> wrote:
Show 9 quoted lines
> Hi Andrew,
>
> On 11-04-12 00:57, Andrew Sayers wrote:
>> Would I be right in thinking that a commit like "Merged r100,r101,r102
>> from trunk" will create three grafts?  If so, that might be the problem.
>
> One SVN 'merge' commit will generate one graft. The graft itself will
> contain all revisions mentioned in the merge commit, and whatever the
> original git parent was before the graft.

This graft does not represent the SVN ´merge´. There are two types of SVN ´merges´, and you are describing the cherry-pick one. So you have to represent them as such, as cherry-pick. And a cherry-pick in git is just a normal commit, it just happens to apply to a different branch (commit), it normally has the same commit message (except some people prefer to add "(cherry pick from commit ...)". And I think this is just what you are looking for.

So, I would recommend you to just rewrite the SVN commit id with git commit sha1. Only in the case where you have a real merge (rev XXX: Merge all history up to rXXX-1 from trunk), you use the graft approach.

Show 13 quoted lines
>
>> Git differentiates between "merges" (which include every commit up to
>> and including the specified one) and "cherry-picks" (which just include
>> the specified commit), whereas SVN calls both of these "merges".  Grafts
>> are a way of creating "merges" rather than "cherry-picks" (which git
>> doesn't have any metadata for), and it's not at all easy to get "merge"
>> data out of SVN in the general case.  Having said that, it's often a
>> good enough heuristic to pick the highest revision number mentioned in
>> the commit message and pretend it's a merge.
>
> The way we 'merged' in SVN was indeed more like cherry-picking, but I'm
> looking to display this information as a merge in Git. I also would like
> to include all revisions if possible.

But git needs a meaningful history!! If you use merges to represent cherry-picks it will confuse some of the git tools.

If the question is to "display this information" in a meaningful way just use the approach outlined above.

>
> The real problem I seem to be having is not completely understanding how
> Git grafts work, because I think I'm hitting some kind of limitation or
> bug, or just not using it right.

If gitk --all freeze theres is definitly a bug somewhere. I don´t really know, but maybe the problem is that some parents in your grafts are descendent of the others.

Anyway, we need a minimal method to reproduce it.

HTH, Santi

Andrew Sayers· Apr 11, 2012, 17:58 UTC · re: Nick Douma · lore

Re: Migrating SVN to Git, and preserve merge information

Thanks Nick for the outline - the main thing I take from this is that "unmerge" is used in real world revision messages, so it's important for me to test that any regexp does the right thing there.

It sounds like grafts aren't the right solution for your problem. I can't really suggest much without a better understanding of what you're trying to achieve, but you might be interested in `git cherry`, which tries to detect cherry-picked commits by comparing the diffs.

	- Andrew

← back to recent threads