Difference between revisions of "Reposurgeon"

From Freephile Wiki
Jump to navigation Jump to search
(more detail)
(This changes nothing)
Line 6: Line 6:
[http://esr.ibiblio.org/?p=4071 From January 2012]:
[http://esr.ibiblio.org/?p=4071 From January 2012]:

Revision as of 09:53, 29 December 2018

Reposurgeon is a tool by Eric Raymond that is for editing version-control repositories. It can be used to migrate from one system to another; like migrating from Subversion to Git. A lot of large software projects [1]have migrated from Subversion to Git, and reposurgeon is one of the few tools that can actually accomplish large migrations.

There are many other tools for importing and even bi-directional interfaces between repositories. However, reposurgeon is probably the best tool for doing large complex migrations.

From January 2012: <

Docs[edit | edit source]

  1. http://www.catb.org/~esr/reposurgeon
  2. http://www.catb.org/~esr/reposurgeon/features.html
  3. http://www.catb.org/~esr/reposurgeon/reposurgeon.html
  4. http://www.catb.org/~esr/reposurgeon/dvcs-migration-guide.html

Usage[edit | edit source]

Reposurgeon works in two modes: interactive, and scripted. The sample file below illustrates a scripted approach. You want to work on a complete (subversion) repo, not a working copy, so you either do a filesystem copy, or svnadmin dump first.

grundlett@hq-1:~$ cat bin/reposurgeon-myheart.sh

# or something like svnrepo=https://svn.example.com/$PROJECT


cd /tmp

# start over with:
#rm $PROJECT-mirror/ $PROJECT-git/ -Rf

echo pull/copy the repository...
# repopuller $svnrepo
# or copy it if it is on the same server:
#cp -av /mount/data/repositories/$PROJECT /tmp/$PROJECT-mirror
echo start conversion...

reposurgeon <<EOF
read /tmp/$PROJECT-mirror
prefer git
references lift
rebuild $gitrepo
echo ...finished

# now filter out all falsely generated .gitignore files:
cd $gitrepo/
git filter-branch --force --index-filter      \
 "git rm --cached --ignore-unmatch $(find . -name .gitignore|xargs )"  \
 --prune-empty --tag-name-filter cat -- --all

Why does reposurgeon generate .gitignore files[2]? Partly because it converts svn:ignore properties. Partly because some tools (git-svn) introduce .gitignore files to the svn repo. I also believe it may have to do with empty directory commits.[3]

See below for a description of the git filter-branch command

Examples[edit | edit source]

Re-writing history[edit | edit source]

This content is probably best associated with Git, but deserves mention here since many migrations will involve manipulating history. With git, you can rewrite history using the filter-branch command

  • drop all empty changesets
    git filter-branch --commit-filter 'git_commit_non_empty_tree "$@"'

Verification[edit | edit source]

List branches sorted by date

git for-each-ref --sort=-committerdate --format='%(refname:short)' refs/heads/

Other[edit | edit source]

  • svncutter is another tool, written in Python, by Eric Raymond. svncutter is for stream surgery on SVN dump files.
  • repopuller comes with reposurgeon, and is a bash script for using svnsync to create a repo 'mirror' that can be used for reposurgery without having to hit the production repository.

References[edit source]