Use git as client for hg repos
This git remote allows you to do local development in a git repository and push changes to an upstream mercurial repository. It does this seamlessly and allows pushing and pulling to named branches in the upstream repository.
It tries not to affect the upstream mercurial repo in any way. Thus, only a restricted git workflow is available to you.
gitifyhg does not rely on hg-git, and allows you to push and pull to and from a mercurial repository from right inside git. You do not need to adapt your git workflow in any way aside from cloning a gitifyhg url.
This is the most robust and usable git to hg bridge currently available. I have studied as many other projects as I could find, and have covered as many use cases as possible. It has a large test suite (over 650 lines and 33 tests), better documentation. I’ve tested it on several large mercurial repositories that break other projects.
That said, gitifyhg is not yet complete. Pull requests are higly desirable. There are 7 tests currently marked as expected failures documenting low hanging fruit if you want to help out with the project. Some of the features that are not fully working include:
- anonymous branches are dropped, only the tip of a named branch is kept
- tags can be cloned and pulled, but not pushed
- bookmarks can be cloned and pushed, but not pulled reliably
However, if you’re looking for a git-svn type of workflow that allows you to clone mercurial repositories, work in local git branches, and rebase your branches, you’ve found it. Further, all of these problems are fixable.
gitifyhg explicitly depends on:
These packages will be installed automatically by easy_install, pip, setup.py install, or setup.py develop.
gitifyhg also expects the following to be installed on your os:
gitifyhg has been tested to run on cPython 2.6 and 2.7. Any python that supports Mercurial should be supported. Sadly, this excludes both pypy and cPython 3.
It has only been tested with Mercurial version 2.4.1. Because it uses Mercurial’s internal APIs, it IS likely to break with other versions.
It has only been tested on Arch Linux. I expect all Linux operating systems to work fine with it and I suspect MacOS will also react well. All bets are off with Windows, but please let me know if it works or you fixed it.
gitifyhg is a properly designed Python package. You can get it from pypi using either
pip install gitifyhg
gitifyhg works in a virtualenv, but you’re probably just as well off to install it at the system level.
You can also install manually with
git clone https://github.com/buchuki/gitifyhg.git python setup.py install
If you want to hack on it, use setup.py develop, instead. In this case, you probably are better off using a virtualenv.
gitifyhg is a git remote. Once installed, you can clone any Mercurial repo using
git clone gitifyhg::<any mercurial url>
Now run git branch -r to see the list of Mercurial branches. If it was a named branch upstream, it will be named branches/<branchname> in git. Bookmarks are referred to directly by their name. For now, I recommend only interacting with named branches.
master automatically tracks the default branch. You can check out any named mercurial branch using
git checkout --track origin/branches/<branchname>
As a standard git practice, I recommend creating your own local branch to work on. Then change to the tracked branch and git pull to get upstream changes. Rebase your working branch onto that branch before pushing
git checkout -b working_<branchname> # hack add commit ad naseum git checkout branches/<branchname> git pull git checkout working_<branchname> git rebase branches/<branchname> git checkout branches/<branchname> git merge working_<branchname> git push
You can create new named upstream branches by giving them the branches/ prefix
git checkout -b "branches/my_new_branch" # hack add commit git push --set_upstream origin branches/my_new_branch
And that’s really it, you just have to use standard git commands and the remote takes care of the details. Just don’t do any octopus merges and you should be good to go.
Note that Mercurial allows spaces in branch, bookmark, and tag names, while git does not. To keep git from choking if upstream has spaces in names, gitifyhg will replace them with three underscores and has the sense to convert between the two formats when pushing and pulling.
If you have any trouble, please let me know via the issue tracker, preferably with pull requests containing test cases.
gitifyhg is copyright 2012 Dusty Phillips and is licensed under the GNU General Public License