Leeiio Chaos Made. » Mercurial

同步你的 Mercurial(Hg) 和 Git 版本库

Leeiio — Wed, 08 Sep 2010 13:59:41 +0000

我的Vim的配置文件之前都是托管在Bitbucket的，因为公司用的也是Hg，所以相对对于Hg使用更熟练一点。虽然Hg和Git都是分布式版本管理工具，但是Hg在使用上以及学习上确实简单不少，很容易上手了。但是还是有很多人是喜欢用Git的，所以我必须要把我的Vim的配置同时用Git来进行版本管理，然后push到著名的Github网站，这样Git使用者也可以很方便的watch以及pull我的最新配置(虽然目前还没有什么人watch…)。

之前的做法比较傻，为了让Git和Hg管理同一个目录，通常操作完Hg的push，然后再用Git进行commit然后push，虽然也是能达到版本库同步的目的，但是很繁琐，因为要分别用Hg和Git进行commit和push操作，有时候还会面临merge问题，实在不是一个好方法。

那肯定是有更好的方法咯？当然！有一个Hg的插件叫做Hg-Git正好满足了这样的需求。

什么是Hg-Git

Hg-Git是Mercurial(Hg)的扩展插件，为Hg增加了从Git服务器pull和push到Git服务器的功能。这意味着你可以从Git的服务器上pull代码然后转变成Hg版本库来进行管理，同时意味着你可以同时把你的Hg版本库push到Git服务器。

安装Hg-Git

简单方式

在你的命令行终端里运行easy_install hg-git，然后查看你的~/.hgrc文件里是否有如下几行代码

[extensions]
hgext.bookmarks =
hggit =

esay_install 是python 包管理工具，它的作用类似于Php中的pear，或者Ruby中的gem，或者Perl中的cpan，或者haskell 中的cabal。

手动方式

从Hg-Git托管在Github的代码库http://github.com/schacon/hg-git/zipball/master里下载然后放置到某个目录。当然前提是你安装了0.4.0或者更新版本的dulwich。你可以使用easy_install ‘dulwich>=0.4.0′ 命令进行安装如果你安装了setuptools。接着打开你的~/.hgrc文件，复制并编辑如下配置

[extensions]
hgext.bookmarks =
hggit = [path-to]/hg-git/hggit

这样就安装好了Hg-Git扩展，这里的配置中bookmarks的配置并不是必须的，但是当在push的时候它会被转化成Git的heads。

用法

如果你想要用Hg clone一個Git版本库，只需使用hg clone [url]便可，例如

$ hg clone git+ssh://git@github.com:Leeiio/Vim.git

push的命令也很简单

$ hg push git+ssh://git@github.com:Leeiio/Vim.git

如果不想每次输入这么长的git服务器地址，你可以打开.hg/hgrc文件，编辑如下

[paths]
default = https://leeiio@bitbucket.org/leeiio/vim
git = git+ssh://git@github.com:Leeiio/Leeiio.git

这样便可以直接使用如下命令来进行push操作了

$ hg push git

更多使用方法参见 http://github.com/schacon/hg-git

同步目前已存在的Hg版本库到Git

从bitbucket服务器clone一份Hg的版本到本地做示范用，如果你本地已经存在一份需要被转换以及同步的Hg版本库就略过此步骤，只要cd要你的Hg管理的项目目录即可。

$ hg clone https://leeiio@bitbucket.org/leeiio/vim vim-test
requesting all changes
adding changesets
adding manifests
adding file changes
added 23 changesets with 418 changes to 239 files
updating to branch default
239 files updated, 0 files merged, 0 files removed, 0 files unresolved
$ cd vim-test/

创建一个bookmark，然后push到Git服务器

$ hg bookmark -r default master
$ hg push git+ssh://git@github.com:Leeiio/vim-test.git
pushing to git+ssh://git@github.com:Leeiio/vim-test.git
importing Hg objects into Git
creating and sending data
git::refs/heads/master => GIT:092e7cf3

如果你想从Git服务器上pull最近的更新的话也可以直接是用Hg的pull命令

$ hg pull git+ssh://git@github.com:Leeiio/vim-test.git
pulling from git+ssh://git@github.com:Leeiio/vim-test.git
importing Hg objects into Git
Total 0 (delta 0), reused 0 (delta 0)
importing Git objects into Hg
(run 'hg update' to get a working copy)

是不是超级简单且强大的一个玩意？如果你也有这样的需求，那么就下载Hg-Git试试吧！

在Google Code上用 Mercurial 取代 Subversion 管理你的项目

Leeiio — Fri, 12 Mar 2010 08:20:39 +0000

之前，我一直都是用的SVN作为我日常的版本控制工具，诸如代码啊文档啊之类的东西。至于CVS这么复古的版本控制工具更是没有机会去尝试。说到SVN控制版本的话，作为托管服务商比较好的就有google code，本人也一直在使用。最近，由于一些项目的原因，了解到了另外一个版本控制工具Hg，当然Hg不是它的原名，原名叫Mercurial，都是水银的意思，所以通常称呼为Hg。

与集中式版本控制工具SVN不同的是，Hg是一种分布式版本控制工具。除了Hg，还有大名鼎鼎的Git也是分布式版本控制工具。想要更具体的了解版本控制工具的，推荐阅读胡凯《为什么我们要放弃Subversion》，
风云《分布式的版本控制工具》，猛禽《分布式版本控制（一）》《分布式版本控制（二）》，Sparkle《我与Mercurial 系列等几篇文章》等。只是想了解Mercurial(Hg)的话，Mercurial官方wiki已经有很详尽的资料和帮助文档了。

接下来回到本文的正题。本文的起因是Google Code在早前除了支持SVN托管代码外，更支持了分布式版本控制Mercurial(Hg)来管理你托管在Google Code上的项目。至于Google为什么在这么多种的分布式版本控制工具中选择了Mercurial而不是Git，这里有一篇文章，推荐阅读一下《Git 與 Mercurial 的分析》，原文《Analysis of Git and Mercurial》。

下面，就教大家怎么让Google Code用Mercurial替代Subversion来管理你的项目。原文 http://code.google.com/p/support/wiki/ConvertingSvnToHg。

在Google Code里设置由Mercurial来管理项目

访问你已经存在的google code项目页面，选择 “Administer” 选项页,然后选择下级分类选项页 “Source”。
改变第一项Repository type为Mercurial。
参照下文介绍的“如何转换Google Code里Subversion的历史记录到Mercurial中”，导入你的代码到 Hg 代码库中
以同样的导入代码的方式，导入你的wiki到Hg wiki库中。确认你使用的subversion代码库的wiki路径(例如 http://projectname.googlecode.com/svn/wiki) 以及 Hg 代码库的wiki路径(http://wiki.projectname.googlecode.com/hg/)

在你切换你的项目使用Mercurial管理后，你的旧Subversion项目仍然可以访问，所以在你切换之前你不需要备份你的代码库。你的Subversion版本库将会保持访问: https://projectname.googlecode.com/svn/

如何转换Google Code里Subversion的历史记录到Mercurial中

第一种方式：简要截取
如果你不在乎你原来项目的历史记录，那么你可以简单地从Subversion里的主干代码或者wiki中提取最新的代码然后放到你的Mercurial中。假设你googlecode里的 Mercurial代码库是空的，那么可以这样操作：

 $ hg clone https://projectname.googlecode.com/hg hg-client
 $ cd hg-client
 $ svn export --force http://projectname.googlecode.com/svn/trunk .
 $ hg add .
 $ hg commit -m "Initial import of source."
 $ hg push

接着转换你的wiki：

 $ hg clone https://wiki.projectname.googlecode.com/hg hg-client-wiki
 $ cd hg-client-wiki
 $ svn export --force http://projectname.googlecode.com/svn/wiki .
 $ hg add .
 $ hg commit -m "Initial import of wiki."
 $ hg push

第二种方式：完整历史记录转换
如果你要迁移你整个的历史记录，整个过程可能要你更多的参与了。你将会需要先安装一些特殊的工具程序。
安装工具

‘hg convert’扩展模块。最新版本的Mercurial已经包含这个模块，请确保你的hg版本为1.1 或者 1.2 或者更高版本。 (可用”hg –version”命令查看) 然后在你的.hgrc里面添加如下代码启用该扩展模块:
```
[extensions]
hgext.convert=
```
Subversion的swig-python绑定。请确保您有最近的Subversion安装（1.5或1.6）。绝大部分的Subversion衍生版本都有与python的绑定，或者提供他们额外的二进制包。你可以运行如下代码检查你的svn – python的绑定是否正常：
```
$ python -c "import svn.core; print svn.core.SVN_VER_MINOR"
        5
```
如果失败，或返回的版本低于5，则肯定是不对的。如果你没有二进制软件包，你可以从Subversion自己的源代码树中建立：
```
$ svn checkout http://svn.collab.net/repos/svn/tags/1.6.0 svn
$ cd svn
$ ./autogen.sh && ./configure
$ make
$ sudo make install
$ make swig-py  # make sure you have swig 1.3 installed already
$ make check-swig-py
$ sudo make install-swig-py
```
如果你在Ubuntu的Hardy版本，你可以在hardy-backports里找到1.5版的python-subversion: http://packages.ubuntu.com/hardy-backports/python-subversion
这可能还需要安装backports里的libsvn1, subversion, mercurial-common, 和mercurial 包。

开始转换
现在我们开始转换– branches(分支), tags(标签)以及其他全部:

$ mkdir hg-client
$ hg convert http://projectname.googlecode.com/svn hg-client

一旦完成转换，你就可以push你最新的历史记录到你的Google Code项目中(前提是你有了一个空的Mercurial版本库):

$ cd hg-client
$ hg push https://projectname.googlecode.com/hg

至此，大功告成。