converting an svn project to git

To get in the right frame of mind, don't think of exporting your entire svn repository, but rather export project by project. Export the trunk of your projects and forget about the branches. If you need data from the branches, merge it first.

1. create a text file somewhere (~/Desktop/users.txt) to map the svn users to git users

   jdoe = John Doe <jdoe@example.com>

2. alter your global config file (~/.gitconfig) to use this user mappings file

   git config --global svn.authorsfile ~/Desktop/users.txt

1. use git svn to clone your svn project to a temporary directory

   git svn clone svn://repo/path/to/myproject myproject_tmp --no-metadata

2. cd into myproject_tmp, and either run gitk or git log to review the author names and emails, to make sure your svn user mappings worked; then cd back up one directory
3. clone the temporary git project directly to a shared location

   git clone --bare myproject_tmp /path/to/shared/git/myproject.git

4. remove the temporary project

   rm -Rf myproject_tmp

5. clone from the shared git repo so you have a direct merge setup with the master branch

   git clone /path/to/shared/git/myproject.git

6. (optional) compare your current svn working copy with the final git working copy, then remove the project from svn

1. create a temporary project directory, and change to it

   mkdir myproject_tmp
   cd myproject_tmp

2. initialize an empty git repository

   git svn init http://host/path/to/your/svn/repo/project/trunk --no-metadata

   • for some reason I've recently had trouble starting this process with git svn init, so I've been doing git svn clone instead. It looks like this:

     git svn clone file:///cygdrive/h/svn/project/trunk myproject_tmp --no-metadata

3. set up the user file for mapping

   git config svn.authorsfile ~/Desktop/users.txt

4. import the svn repository

   git svn fetch

5. change up one directory, and clone this newly created repository (this cleans up all svn stuff)

   cd ..
   git clone myproject_tmp myproject

6. the myproject_tmp directory can now be removed, and the origin remote

   rm -Rf myproject_tmp
   cd myproject
   git remote rm origin

7. if you want to push this out to a shared repo, you can do it like this

   cd /path/to/shared/dir
   mkdir project.git
   cd project.git
   git init --bare --shared
   cd /path/to/myproject
   git push /path/to/shared/dir/myproject.git refs/heads/master
   (you can push other refs if you want at this point, if they should be public)
   
   (then I usually git clone from this shared repo for good measure to make sure it all works; your merge paths will work by default too)

8. you should also consider that although svn allows empty directories as part of the repo, git does not; we usually fix this by adding empty files named .emptydir in any directory that needs it

• importing an svn repository