代码管理 TopGit(Topic Git)改进

群英汇 TopGit 改进(1): tg push 全部分支TopGit 的项目名称是来自于 Topic Git 的简写，是用于管理多个 Git 的特性分支的工具。如果您对 Hg 的 MQ 有所了解的话，我可以告诉你，TopGit 是用Git 维护补丁列表的工具；TopGit 就是 MQ 在 Git 中的等价物，而且做的更好。

1.什么是 TopGit？参见TopGit 手册

2.TopGit 代码库：http://repo.or.cz/w/topgit.git

群英汇终于决定采用 Git 作为公司内部的代码管理工具，就是因为我们发现了TopGit。参见：《群英汇版本控制系统的选择：subversion, hg, git》。

在每日的使用过程中，我们也发现了 TopGit 的一些问题，不断的挠到我们的痒处。遵循ESR的理论，我们决定对 TopGit 进行改进，于是就有了我们在 Github 上的 TopGit 版本库：https://www.360docs.net/doc/959888257.html,/ossxp-com/topgit

最近，我又感觉到 TopGit 一个不便利的地方，今天终于临时决定 Hack。Hack 结束之后，就有了写一个系列文章的想法，于是这个系列文章，就从今天这个最新的 Hack 写起。

为 tg push 命令增加 –all 参数

我之前的一篇文章：《Git 如何拆除核弹起爆码，以及 topgit 0.7到0.8的变迁》，曾经提到过，TopGit 0.7 到 0.8 的一个非常大的改变，就是取消了

在 .git/config 中的强制 non-fast-forward 更新的 push 参数。

在 TopGit 0.7 以及之前的版本，可以通过执行一个简单的git push命令，就可以将所有的 TopGit 分支以及相关的 top-bases 分支 PUSH 到服务器上。

但是 TopGit 0.8 版本之后，不再向 .git/config 中添加相关 PUSH 指令，因为强制 non-fast-forward 的 PUSH 会导致多人协同工作时，互相覆盖对方改动！！！但是这么做的结果，也就失去了使用 git push 向远程服务器同步 TopGit 分支的便利。

TopGit 0.8 版本提供了一个新命令tg push，用于向服务器 PUSH TopGit 分支以及关联的 top-bases 分支。这样，就弥补了不能再使用 git push 和服务器同步 TopGit 以及 top-bases 分支的遗憾了。

一个让人痒痒的问题产生了：

?tg push 只能 push 当前工作的 TopGit 分支；

?或者 tg push 后面加上各个分支的名字，实现对分支的 PUSH

?但是 tg push 没有一个 –all 选项，必须一个一个的将需要 PUSH 的 tg 分支罗列出来

?我们有的项目的分支有上百个！！！如果改动的多的话，要一个一个切换或者一个一个写在命令行中，太恐怖了。

问题的解决：

?增加了对 -a 以及 –all 参数的支持

?如果用户没有指定分支，并且提供了-a | –all 参数，则将当前所有 topgit 分支加入同步的分支列表中

?创建新的分支，开始写代码：

?$ tg create t/tg_push_all tgmaster

?tg: Creating t/tg_push_all base from tgmaster... ?Switched to a new branch 't/tg_push_all'

?tg: Topic branch t/tg_push_all set up. Please fill .topmsg now and make initial commit.

?tg: To abort: git rm -f .top* && git checkout tgmaster && tg delete t/tg_push_all

?

?# Hack, Hack, Hack...

?# Test, Test, Test...

?

?$ git st

?# On branch t/tg_push_all

?# Changes to be committed:

?# (use "git reset HEAD ..." to unstage)

?#

?# new file: .topdeps

?# new file: .topmsg

?#

?# Changed but not updated:

?# (use "git add ..." to update what will be committed)

?# (use "git checkout -- ..." to discard changes in working directory)

?#

?# modified: .topmsg

?# modified: tg-push.sh

?#

?

?$ git ci -a -m "add --all option support to tg_push"

?[t/tg_push_all 7df16a5] add --all option support to tg_push

? 3 files changed, 22 insertions(+), 1 deletions(-)

? create mode 100644 .topdeps

create mode 100644 .topmsg

切换到 master (debian) 分支，编译新

?的群英汇软件包topgit＋，并安装

$

?git co master

?$ git br

* master

?

? t/debian_locations

? t/export_quilt_all

? t/fast_tg_summary

? t/tg_completion_bugfix

? t/tg_patch_cdup

? t/tg_push_all

? tgmaster

?$ make -f debian/rules debian/patches

rm -rf deb

?ian/patches

?tg export --quilt --all debian/patches

?Exporting t/debian_locations

?Exporting t/export_quilt_all

?Exporting t/fast_tg_summary

?Exporting t/tg_completion_bugfix

?Exporting t/tg_patch_cdup

?Exporting t/tg_push_all

?Exported topic branch (total 6 topics) to directory debian/patches

?$ git st

?# On branch master

# Changed but

? not updated:

?# (use "git add ..." to update what will be committed)

?# (use "git checkout -- ..." to discard changes in working directory)

?#

# mo

?dified: debian/patches/series

?#

# Untracked files:

?

?# (use "git add ..." to include in what will be committed)

?#

?# debian/patches/t/tg_push_all.diff

?no changes added to commit (use "git add" and/or "git commit -a")

?$ git add debian/patches/t/tg_patch_all.diff

?$ vi debian/changelog

edit, edit, edit...

?

?$ head -5 debian/changelog

topgit (0.8-1+ossxp7) unstable; urgency=low

?

?

? * add --all support to tg patch.

?

? -- Jiang Xin

git ci -a -m "new patch: add --all option support to tg_push."?$

?[master c927b02] new patch: add --all option support to tg_push.

? 3 files changed, 61 insertions(+), 0 deletions(-) ? create mode 100644 debian/patches/t/tg_push_all.diff ?

$ dpkg-build

?package -b -rfakeroot

...

?

?dpkg-deb：正在新建软件包“topgit”，包文件为

“../topgit_0.8-1+ossxp7_all.deb”。

dpkg-genchanges -b

?

>../topgit_0.8-1+ossxp7_amd64.changes

...

?

$ sudo dp8-1+ossxp7

?kg -i ../topgit_0._all.deb

...

改SH 到 Github

?动 PU

?$ git remote -v

?github git@https://www.360docs.net/doc/959888257.html,:ossxp-com/topgit.git (fetch) gi

?thub git@https://www.360docs.net/doc/959888257.html,:ossxp-com/topgit.git (push) ?origin git@https://www.360docs.net/doc/959888257.html,:users/jiangxin/topgit.git (fetch)

?origin git@https://www.360docs.net/doc/959888257.html,:users/jiangxin/topgit.git (push)

?upstream git://repo.or.cz/topgit.git (fetch) ?upstream git://repo.or.cz/topgit.git (push) $ tg -r g

?ithub summary

?r t/debian_locations [PATCH] make file locations Debian-compatible

?r t/export_quilt_all [PATCH] t/export_quilt_all

?r t/fast_tg_summary [PATCH] t/fast_tg_summary

r t/tg_completion_bugfix

? [PATCH] t/tg_completion_bugfix

?r t/tg_patch_cdup [PATCH] t/tg_patch_cdup

?l t/tg_push_all [PATCH] t/tg_push_all

?$ tg -r github push --all

Everything up-to-date

?

?Everything up-to-date

Everything up-t

?o-date

?Everything up-to-date

Everything u

?p-to-date

?Counting objects: 7, done.

?Delta compression using up to 2 threads. ?Compressing objects: 100% (4/4), done.

?Writing objects: 100% (5/5), 757 bytes, done. ?Total 5 (delta 2), reused 0 (delta 0)

?To git@https://www.360docs.net/doc/959888257.html,:ossxp-com/topgit.git

?* [new branch] refs/top-bases/t/tg_push_all -> refs/top-bases/t/tg_push_all

[new branch] t/tg_push_all -> t/tg_push_al * l

改

?完，收工。

相关代码提交：

ht /https://www.360docs.net/doc/959888257.html,/ossxp-com/topgit/commit/tp:/Git , topgit , 版本控制分享这篇文章由 蒋 鑫 于 2010年1月15日 - 14:47发表于北京群英汇信息文章技术有限公司https://www.360docs.net/doc/959888257.html, 。，分类于 Git , 版本控制。

群英汇 TopGit 改进 (2): tg 导出全部分支

实际上这个补丁 export_quilt_all 才是我们在 topgit 上的第一个补丁。那么是什么原因导致我们奇痒无比，需要改动 Topgit 的代码呢？

我们使用 topgit 维护了几个开源项目，其工作模式是在几个特性分支中工作，作结束后，将特性分支导出到 Quilt 格式的补丁列表。导出特性分支为 quilt 工补丁的命令行是：

? 将当前工作的特性分支及其依赖的特性分支导出到 quilt 格式的补丁中 $ tg export --quilt EXPORT_DIR

如果需要导出多个特性分支，需要使用命令

$ tg export -b BRANCH1,BRANCH2,... --quilt EXPORT_DIR

? 这个命令主要的问题是，难以维护。如果我们把导出命令写入脚本，一旦特性分支增加或者删除，还要维护脚本。

导出，我们曾经采用这个办法，避免过于复杂的?

t/all 分支依赖其他所有特性分支 为了方便将所有的特性分支一次性命令行：

?

创建一个分支名为 t/all

? 当在 t/all 分支，导出到 quilt 格式补丁列表时，包含了所有的特性分支

但是，这么做的副作用更大：? 仍然难以维护。在创建一个新的特性分支时，会忘记将其加入到 t/all 的

依赖中

分支都要重新执行 rebase ，最后导致代码库历

史当们最的? 当任何分支有提交，t/all 极为混乱

我决定公开代码库到 Github 上时，我们觉得 t/all 分支实在是太难看了。于是决定 Hack ！

终结果：使用一个简单的命令导出所有分支 tg export --all --quilt EXPORT_DIR

$ 这就是我们的 “tg 导出全部分支”的补丁。参见：

群英汇在Github 上的代码库Git , topgit , 版本控制分享这篇文章由 蒋 鑫 于 2010年1月18日 - 22:00发表于北京群英汇信息技术有限公司https://www.360docs.net/doc/959888257.html, 文章。，分类于 Git , 版本控制。

群英汇 To it 改进 (3): 更灵活的 tg patch

pG 命令 tg patch 命令，就类似 Hg/MQ 的 hg qdiff 命令，用于查看当前特性分支所有改动。

这个命令很常用，但是很快就发现这个命令的一个问题：即只能在代码库的根下执行，在任何子目录中执行问 tg patch ，显示的结果为空！有好几次都因为这个骗了。这是什么原因呢？

题被

用 tg patch 查看补丁，可以运行在任意目录下

命令 tg patch ，是在 Topgit 的代码 tg-patch.sh 中完成的。经过分析代码（shell 脚本）很快就定位到问题所在，只要在执行特定的命令前，切换到版本库的根目录就可以了。可是如何判断当前路径和版本库根路径的关系呢？答案就在： git rev-parse --show-cdup

这条命令返回的是要从版本库工作区的某个目录，返回到版本库根路径要经过的路径。

?

可能是空 —— 当前就是根 ?可能是 ../ —— 在版本库的一级子目录中

?

可能是 ../../ —— 在版本库的二级子目录中 ? 依次类推

分支中，参见：

https://www.360docs.net/doc/959888257.html,/ossxp-com/topgit/blob/t/tg_patch_cdup/tg-patch.sh 于是很简单的，我们的改进就诞生了。诞生在 群英汇 Topgit 改进的 tg_patch_cdup Git , topgit , 版本控制分享文章这篇文章由 蒋 鑫 于 2010年1月19日 - 22:25发表于北京群英汇信息技术有限公司https://www.360docs.net/doc/959888257.html, 。，分类于 Git , 版本控制。

群英汇 TopGit 改进 (4): tg 命令补齐

在境下，Linux 命令的命令补齐非常强大。

Bash 的 Shell 环

? 首先，要确保安装了 bash-completion 包 dpkg -l bash-completion

? $ ? ||/ 名称 版本 简介

?

+++-=================-=========-========================================== ii bash-completion 1:1.1-3 programmable completion for the bash shell

? 有确认 Bash 的配置文件还/bash.bashrc 已经开启了命令补齐，如

下 /etc ：

?

letion ]; then if [ -f /etc/bash_comp ? . /etc/bash_completion fi

? it 也提供 Bash 下的命令补齐，相应的脚本在目录

/etc/bash_completion.d/

但是 Topgit 的命令补齐有一个问题，就是在执行 tg depend 命令，通过敲击 TAB 键获取分支列表或者自动补齐分支名称时出现异常！

Topg 下$ tg depend bash: __git_find_subcommand: command not found

add

命令补齐报错！这是如何产生的呢？如何解决呢？

T opGit 命令行补齐的Bugfix

如前所述，理解了bash 命令补齐的原理，就能很容易解决这个问题。

这是在 /etc/bash.bashrc 中完成加载的。

/etc/bash_completion 脚本将 /etc/bash_completion.d/ 目录下的各个误可以看出来，命令补齐执行了一个不存在的命? Bash 命令补齐，需要在 shell 运行时，加载 /etc/bash_completion 脚本。一般? 命令补齐的配置脚本读入环境变量中。

那么我们从 tg 命令补齐的错令：__git_find_subcommand ，那么执行下面的命令，就非常清楚了： set | grep -C3 __git_find_subcommand

$ _tg_depend ()

{

local subcommands="add";

local subcommand="$(__git_find_subcommand

"$subcommands")"; if [ -z "$subcommand" ]; then

__tgcomp "$subcommands";

return;

于是，剩下的事情就很简单了，找到 git 命令补齐中最新的分支扩展的实现脚解决问题了。改动后的相应的脚本：

本就$ set | grep -C3 __git_find_subcommand

_tg_depend ()

{

local subcommands="add";

local subcommand="$(__git_find_subcommand "$subcommands" 2>/dev/null || __git_find_on_cmdline "$subcommands" 2>/dev/null)"; if [ -z "$subcommand" ]; then __tgcomp "$subcommands"; return;

代码我们提交到 Github 上，于您分享

群英汇 在 Github 上的 topgit 代码库的相关提交。

Git , topgit , 版本控制分享这篇文章由 蒋 鑫 于 2010年1月22日 - 09:39发表于北京群英汇信息.com 文章技术有限公司http://www.ossxp 。，分类于 Git , 版本控制。

群英汇 TopGit 改进 (5): tg summary 执行的更快

关于 tg summary 速度改进，其实不是因为 tg summary 使用中发现的问题。tg summary 是在使用 topgit 最常用到的命令。该命令用于查看各个功能分支和版本库的同步关系。

一般情况下，不太容易受到这个小问题的干扰，但是如果存在近百个功能分支，有问题了：

看当命令 git co 按下命令，瞬间就提供分支名的自动补齐

就? 执行 tg create ，即在 tg create 命令后按下 Tab 键，想查前分支列表，会发现速度很慢，需要一秒钟甚至更长的时间相应。可是用? tg depend 命令也存在类似问题

?tg patch 命令如果按下 Tab 键，也存在类似问题

?…

追溯

根源，找到原来是tg summary -t命令的性能问题。命令补齐实际上是调用的tg summary -t 命令来获取 topgit 分支的。

看看改进前和改进后，执行tg summary -t 命令的效率：

?改进前：

?$ time tg summary -t >/dev/null

?

?real 0m1.799s

?user 0m0.580s

?sys 0m0.868s

?改进后：

$ time tg summary

? -t >/dev/null

?

real 0m0.040s

?

?user 0m0.016s

sys 0m0.020s

可以看出改进后，执行时间由 1.8 秒缩短为仅仅 0.04 秒?

我们是如何改进的呢？非常简单，简单到有些不好意思，您去 Github 上看看吧。

群pgit 代码库

?英汇在 Github 上的 to

Git, topgit, 版本控制

分享这篇文章由蒋鑫于 2010年1月23日 - 21:27发表于北京群英汇信息文章。，分类于Git, 版本控制。

技术有限公司https://www.360docs.net/doc/959888257.html,