git-svn-helpers 0.9

基本用法

执行摘要

> cd path/to/svn/repo
> gitify init

执行本地更改并将其提交到git。当准备好推送更改时

> gitify push

以更新工作目录的上游更改

> gitify update

gitify将确保您的git和svn仓库保持同步，并在更新时尽力避免冲突。

示例会话

以下是一个示例会话

> cd /tmp
> svn co https://svn.plone.org/svn/plone/plone.app.form/branches/1.1 plone.app.form
A    1.1/setup.py
...
Checked out revision 27228.
> cd plone.app.form
> gitify init
No git repository found in /Users/tomster/.gitcache/.
Initiating cloning into cache.
Analyzing svn log...
Cloning https://svn.plone.org/svn/plone/plone.app.form/ from r10593:34543 into /Users/tomster/.gitcache/
Initialized empty Git repository in /Users/tomster/Development/gitcache/plone.app.form/.git/
...
Git branch 'local/1.1' is now following svn branch '1.1':
# On branch local/1.1
nothing to commit (working directory clean)
> git branch
* local/1.1
  master

注意事项

• gitify限制了克隆到包根目录（在此处为https://svn.plone.org/svn/plone/plone.app.form/）中SVN日志中找到的修订版本。这可以节省大量时间，尤其是在大型仓库（如plone.collective）中。

• gitify创建了一个名为local/1.1的本地分支，该分支跟踪（远程）SVN分支1.1，并将其切换到该分支。

• gitify假设包的名称是从其被调用的目录的名称（在此例中为plone.app.form），因为它拒绝猜测。

同一包的多重签出

在实践中，您通常会处理给定仓库的不同本地副本，即在主分支和功能分支上。这时，上面创建的.gitcache目录就派上用场了。让我们将之前的签出移除，并创建一个维护签出，该签出跟踪主分支。

> cd ..
> mkdir feature-branch
> mv plone.app.form feature-branch/
> mkdir maintenance
> cd maintenance/
> svn co https://svn.plone.org/svn/plone/plone.app.form/trunk plone.app.form
A    plone.app.form/setup.py
...
 U   plone.app.form
Checked out revision 27228.

如果我们在这里运行gitify会发生什么？

> cd plone.app.form/
> gitify init
Updating existing cache:
fetching /Users/tomster/.gitcache/plone.app.form
Done. 1 packages updated.
Git branch 'local/trunk' is now following svn branch 'trunk':
# On branch local/trunk
nothing to commit (working directory clean)

请注意，这个操作的速度要快得多，因为我们现在已经使用了缓存目录中现有的git仓库，从而避免了缓慢且网络密集的克隆操作。

这一点可以通过查看现在可用的本地分支进一步证明。注意git仓库中包含主分支和1.1分支。

> git branch
  local/1.1
* local/trunk
  master

切换分支

如果SVN仓库切换到另一个分支（例如，由于svn:externals或buildout源中的更改），则git所在的分支与当前的SVN分支不同。要解决这个问题，您可以选择手动切换git或重新运行gitify init。

> svn info
URL: https://svn.plone.org/svn/plone/plone.app.form/trunk

> git branch
  local/1.1
* local/trunk
  master

如果切换SVN分支，git最初不会捕获更改，分支将不同。

> svn switch https://svn.plone.org/svn/plone/plone.app.form/branches/1.1
> svn info
URL: https://svn.plone.org/svn/plone/plone.app.form/branches/1.1

> git branch
  local/1.1
* local/trunk
  master

重新运行gitify init后，它们将再次相同。

> git branch
* local/1.1
  local/trunk
  master

保持缓存更新

当然，一旦您引入了缓存，您需要保持其更新。《span class="docutils literal">git-svn》提供了fetch命令用于此目的。实际上，手动更新每个包是非常麻烦的。因此，我们提供了自己的fetch命令，该命令可以使用通配符一次更新多个包，如下所示：

> gitify fetch plone*
fetching /Users/tomster/.gitcache/plone.app.form
fetching /Users/tomster/.gitcache/plone.pony
fetching /Users/tomster/.gitcache/plonenext
Done. 3 packages updated.

您可以将-v选项传递给查看git-svn fetch命令的输出。如果不提供包，则更新所有包。

请注意，我们的fetch命令永远不会触摸任何工作副本，只触摸缓存。它主要是作为维护命令运行的，即通过crontab来保持本地缓存“新鲜”。

保持git和svn同步

由于本地文件系统同时是git仓库以及SVN签出（换句话说，我们同时有.git和.svn），因此它们应尽可能保持同步。按照设计，这只能在我们有在线访问SVN仓库的情况下发生。因此，最好在提交回SVN时执行此操作。手动执行此操作的方法是首先执行dcommit，然后执行svn up --force命令（--force是必要的，这样SVN就不会被已提交的新文件打扰）。gitify push提供了一个方便的命令，可为您执行此操作。

> gitify push -v
Committing to https://svn.plone.org/svn/plone/plone.app.form/branches/1.1 ...
At revision 27229.
INFO: Pushed local changes to svn.
> svn st
<BLANKLINE>

安装

只需使用easy_install，可选地使用virtualenv

> easy_install git-svn-helpers

需求

git-svn-helpers要求已经安装了git（带有子版本控制支持，即git-svn）。

待办事项

• 添加对自定义SVN布局的支持