goodmami/README.md

## README.md

      
    Raw
  

              README.md
            
          
    Converting ACE from Subversion to Git

The ace-svn-to-git.sh script will use git-svn to convert ACE's Subversion
repository to Git with the --stdlayout flag so the trunk, tags, and branches
are handled mostly as expected (more below). The --prefix=svn/ option puts
all of those tags and branches under the svn reference namespace, and the
--authors-file option maps the Subversion author names to the current GitHub
profiles of the three authors in ACE's history.
Initial Conversion

Just run:
./ace-svn-to-git.sh
Note that it will create an authors.txt file in the current directory
(overwriting any existing file with the same name) and it will create the
repository in an ace/ subdirectory.
Subsequent Cleanup

The conversion works mostly as expected, but Subversion's tags are not tags in
Git but remote branches. This is because tags in Subversion are just like
branches and can be modified. Here we assume that the tags will never be
modified and the script converts them to Git tags, then deletes the remote
(tag) branches.
The trunk remote branch is then created as a regular Git branch so it can be
checked out.
Finally, the master branch is renamed to main, following the current
convention.
Pushing to GitHub

Once everything looks good, it can be pushed to GitHub by setting the remote
and pushing all branches. Note that git push --all does not push remote
(svn/) branches that have not been converted to Git branches, nor does it
push tags, which is then accomplished with git push --tags.
git remote add origin https://github.com/delph-in/ace.git
git push -u origin --all
git push -u origin --tags
Syncing to Subversion

The trunk branch should never be committed to directly. Instead, it should
be kept up-to-date with the Subversion repository as follows:
git checkout trunk
git svn rebase
git checkout main  # don't remain on trunk to avoid accidental commits
The main branch can then merge in commits from trunk, e.g., when a new
release is ready.
Note that the above steps only work if the local repository has the relevant
SVN metadata (e.g., if it was the one that originally cloned from SVN). If not,
the update.sh script in this gist will attempt to reconfigure Git to know
about the SVN repo and rebuild the metadata. This should also work from a fresh
clone from GitHub.
Notes

The GitHub Importer tool does a great job at converting a subversion
repository to a conventional-looking Git repository. It does not, however, keep
the relevant metadata necessary for syncing the Git repo with subsequent
changes to the Subversion repo. Part of this metadata includes lines appended
to every commit message imported from Subversion, and another part exists
within the .git/svn/ subdirectory.

  
## ace-svn-to-git.sh
#!/bin/bash

cat <<EOF > authors.txt
sweaglesw = Woodley Packard <sweaglesw@users.noreply.github.com>
oe = Stephan Oepen <oepen@users.noreply.github.com>
djwong = Darrick Wong <djwong@users.noreply.github.com>
(no author) = (no author) <(no author)>
EOF

git svn clone http://sweaglesw.org/svn/ace --stdlayout --prefix=svn/ --authors-file=authors.txt

# change to cloned repo directory
pushd ace

# convert SVN tag branches to Git tags, then delete the branch
# thanks: https://stackoverflow.com/a/14800155/1441112
git for-each-ref --format="%(refname:short) %(objectname)" refs/remotes/svn/tags \
  | while read BRANCH REF
    do
        TAG_NAME="${BRANCH##*/}"
        BODY="$(git log -1 --format=format:%B $REF)"
        echo "ref=$REF parent=$(git rev-parse $REF^) tagname=$TAG_NAME body=$BODY" >&2
        git tag -a -m "$BODY" $TAG_NAME $REF^  &&\
        git branch -r -d "$BRANCH"
    done

# rename master to main
git branch -m main

# create trunk branch
git branch trunk refs/remotes/svn/trunk

popd
rm authors.txt

echo "Now: create an empty repository on GitHub (e.g., delph-in/ace)"
echo "Run the following:"
echo "  git remote add origin https://github.com/delph-in/ace.git"
echo "  git push -u origin --all"
echo "  git push -u origin --tags"


## update.sh
#!/usr/bin/bash

if [ "$( git branch --show-current )" != "trunk" ]; then
    echo "Run from the trunk branch: git checkout trunk"
    exit 1
fi

# ensure the trunk remote ref points to the head of the trunk branch
git update-ref refs/remotes/svn/trunk refs/heads/trunk

# ensure the config is set appropriately
git config --local svn-remote.svn.url http://sweaglesw.org/svn/ace
git config --local svn-remote.svn.fetch trunk:refs/remotes/svn/trunk
git config --local svn-remote.svn.branches branches/*:refs/remotes/svn/*
git config --local svn-remote.svn.tags tags/*:refs/remotes/svn/tags/*

# create the authors file and set its config path
if [ ! -f ./authors.txt ]; then
    cat <<EOF > ./authors.txt
sweaglesw = Woodley Packard <sweaglesw@users.noreply.github.com>
EOF
fi
git config --local svn.authorsfile ./authors.txt

# fetch and rebase from SVN
git svn rebase

echo "Done. Don't forget to switch out of the trunk branch to avoid accidental commits."
	#!/bin/bash

	cat <<EOF > authors.txt
	sweaglesw = Woodley Packard <sweaglesw@users.noreply.github.com>
	oe = Stephan Oepen <oepen@users.noreply.github.com>
	djwong = Darrick Wong <djwong@users.noreply.github.com>
	(no author) = (no author) <(no author)>
	EOF

	git svn clone http://sweaglesw.org/svn/ace --stdlayout --prefix=svn/ --authors-file=authors.txt

	# change to cloned repo directory
	pushd ace

	# convert SVN tag branches to Git tags, then delete the branch
	# thanks: https://stackoverflow.com/a/14800155/1441112
	git for-each-ref --format="%(refname:short) %(objectname)" refs/remotes/svn/tags \
	\| while read BRANCH REF
	do
	TAG_NAME="${BRANCH##*/}"
	BODY="$(git log -1 --format=format:%B $REF)"
	echo "ref=$REF parent=$(git rev-parse $REF^) tagname=$TAG_NAME body=$BODY" >&2
	git tag -a -m "$BODY" $TAG_NAME $REF^ &&\
	git branch -r -d "$BRANCH"
	done

	# rename master to main
	git branch -m main

	# create trunk branch
	git branch trunk refs/remotes/svn/trunk

	popd
	rm authors.txt

	echo "Now: create an empty repository on GitHub (e.g., delph-in/ace)"
	echo "Run the following:"
	echo " git remote add origin https://github.com/delph-in/ace.git"
	echo " git push -u origin --all"
	echo " git push -u origin --tags"
	#!/usr/bin/bash

	if [ "$( git branch --show-current )" != "trunk" ]; then
	echo "Run from the trunk branch: git checkout trunk"
	exit 1
	fi

	# ensure the trunk remote ref points to the head of the trunk branch
	git update-ref refs/remotes/svn/trunk refs/heads/trunk

	# ensure the config is set appropriately
	git config --local svn-remote.svn.url http://sweaglesw.org/svn/ace
	git config --local svn-remote.svn.fetch trunk:refs/remotes/svn/trunk
	git config --local svn-remote.svn.branches branches/:refs/remotes/svn/
	git config --local svn-remote.svn.tags tags/:refs/remotes/svn/tags/

	# create the authors file and set its config path
	if [ ! -f ./authors.txt ]; then
	cat <<EOF > ./authors.txt
	sweaglesw = Woodley Packard <sweaglesw@users.noreply.github.com>
	EOF
	fi
	git config --local svn.authorsfile ./authors.txt

	# fetch and rebase from SVN
	git svn rebase

	echo "Done. Don't forget to switch out of the trunk branch to avoid accidental commits."