git:我如何以编程方式确定是否需要拉动或推动？

Question

我正在编写一个程序来检查几个克隆的git存储库的状态.

如何判断我的存储库是否需要"git pull"或"git push"？

Answer 1

首先,pull只是fetch后面merge(或rebase).这很重要,因为您首先想要的是一个相关的,更简单的问题的答案:与某些远程存储库相比,您的本地存储库有多远和/或落后？(对于TL; DR回答,请跳到下面的第一个标题部分.)

还有其他潜在的复杂情况,但这里最简单的方法是检查你的分支提示与其他一些git存储库/那些.为了便于说明,我们给它们一些名字.我们可以将您的存储库称为"L"(对于本地),并且假设有两个额外的存储库"RA"(远程A)和"RB",它们在远程名称RA和RB下存储在本地存储库L中的URL.

获取所有可能需要的所有内容的简单方法是在RA和RB上运行git fetch(或git remote update).(我们会看到一种延迟提取的方法,虽然我不确定它是否有任何实际价值.)

给定一个典型的设置,获取两个遥控器将复制其本地分支您自己的"远程分支".让我们假设RA有master和devRB有master和feature,所以在你的提取完成之后:

L$ git rev-parse --short refs/remotes/RA/master
feedbee
L$ git rev-parse --short refs/remotes/RA/dev
feedbee
L$ git rev-parse --short refs/remotes/RB/master
badf00d
L$ git rev-parse --short refs/remotes/RB/feature
c0ffee1

(这些数字是组成的,但仅用于说明.另外,如果你在实际代码中这样做,你不会想要--short.而且,你可以缩写分支名称,省略refs/remotes/- 和 - ,refs/heads/- 只要 -它们是明确的.但是,如果你是脚本,那么使用全名可能更明智.以防万一.)

现在让我们检查一下你自己当地分支机构的提示:

L$ git rev-parse --short refs/heads/master
feedbee

这意味着您master与RA master同步,与其同步dev.因此,必须没有任何东西可以推送或获取(尽管你已经取出以便找到它),因此也没有任何合并或重组.

另一方面,远程RB 不同步作为其master提交点badf00d.这是否意味着你有合并的东西,或者推动什么？也许,也许不是:这就是并发症的来源.如果需要手动合并,Git无法提供太多帮助,但是你可以通过查看提交方式来了解RB是"先行","落后"还是两者兼而有之图形相互叠加.

如果repo L严格"在"repo RB之前,即你有可以推送的东西,那么图形片段必须如下所示:

... - o           <-- RB/master: tip-most commit = badf00d
        \
          o - o   <-- master: tip commit = feedbee

这里L是"2提前",在git status给你的条款中,repo RB的位置.如果你对RB进行了推送,那么git会将最后两次提交交给RB并告诉它请将其设置master为feedbee,这样就可以了解它.

如果repo L严格"落后"RB,那么图形片段将看起来相同,但标签将颠倒:

... - o           <-- master
        \
          o - o   <-- RB/master

在这种情况下,如果你做了合并,使RB/master进master,GIT中会看到一个快进和你的主人设置badf00d.此时repo RA将落后,你可能想要推进那里.

但仍有两种可能性.L时既超前和落后,例如:

... - o - o       <-- master
        \
          o - o   <-- RB/master

这需要一个rebase或一个真正的合并,如果git不能自己组合各种变化(或者即使它可能,它可能会让它们错误),其中任何一个都需要手动手持.

最后,虽然不太可能,但两个分支提示是完全无关的(部分中没有共同的祖先...):

... - o   <-- master

... - o   <-- RB/master

这是最难处理的,因为我在下面描述的内容给出了错误的前/后计数.(如果某人已经离开并重写了其中一个克隆的所有历史记录,它也只能发生在克隆的回购中.git merge-base例如,使用这种情况添加偏执检查可能是合理的.但我会忽略它从这里开始.)

发现前后数量

尽管如此,这里是找到两个分支(一个本地,一个远程)的"前方"和"后方"计数的快速方法,您知道这两个分支是相关的.我将切换到远程"origin",这是(单个)克隆源的通常名称,并使用分支名称的简短形式:

$ ahead=$(git rev-list --count origin/master..master)
$ behind=$(git rev-list --count master..origin/master)

这些使用gitrevisions范围语法来选择可从本地分支提示(由其标识的提交master)而不是远程分支提示(由其标识)可访问的修订origin/master.

如果你领先但不落后,你可以放心git push.如果你是落后但不是未来你可以安全git merge地获得快进(此时没有意义,pull因为你已经完成了这fetch一步).如果你俩都领先和落后,这样既计数为零,则必须合并或重订,以及如果这些做不到之间做出选择.当然,如果两个计数都为零,则两个分支提示标识相同的SHA-1,并且不需要执行任何操作.

如果你不想使用git fetch怎么办？

最终你必须使用git fetch.但是,如果你愿意,你可以从一开始git ls-remote,吐出一个SHA-1列表并重新命名:

$ git ls-remote
From [url redacted]
a17c56c056d5fea0843b429132904c429a900229    HEAD
ca00f80b58d679e59fc271650f68cd25cdb72b09    refs/heads/maint
a17c56c056d5fea0843b429132904c429a900229    refs/heads/master
0029c496ce1b91f10b75ade16604b8e9f5d8d20b    refs/heads/next
fcd56459647e0c41f2ea9c5b7e2ed827f701fc95    refs/heads/pu
e8f6847178db882bd42d5572439333ca4cb3222e    refs/heads/todo
d5aef6e4d58cfe1549adef5b436f3ace984e8c86    refs/tags/gitgui-0.10.0
3d654be48f65545c4d3e35f5d3bbed5489820930    refs/tags/gitgui-0.10.0^{}
[mass snippage]

如果遥控器上的SHA-1与本地SHA-1不同,这些SHA-1 不包含您需要的所有图形信息,但如果您关心的SHA-1匹配,那么您可以知道没有什么可以提取或推.此外,如果它们不同,您可以查看是否有相应的SHA-1.例如,上面显示了远程master指向提交a17c56c056d5fea0843b429132904c429a900229.如果我拥有它(我没有),我可以使用它作为一个说明者,git rev-list --count找出遥控器背后有多远.因为我没有它,我几乎肯定落后了:我不知道多少,但我需要取,然后可能合并或变基(我不知道我是否领先,直到我取).

你怎么知道要看哪个分支？

这可能是最好的事先确定,而不是仅仅迭代所有可能的分支.但是,如果你想遍历分支机构,这种情况的工具git for-each-ref,这需要相当多的争论.要查找您自己的本地分支,例如:

$ git for-each-ref --format='%(refname)' refs/heads
refs/heads/master
refs/heads/precious
refs/heads/stash-exp

找到遥控器origin的分支:

$ git for-each-ref --format='%(refname)' refs/remotes/origin
refs/remotes/origin/maint
refs/remotes/origin/master
refs/remotes/origin/next
refs/remotes/origin/pu
refs/remotes/origin/todo

剥离足够的这些字符串并匹配分支名称很容易,以便能够比较它们.如果要检查(并跳过)匹配的SHA-1,使用其他选项可以获得分支名称和SHA-1,这显然会为前后计数提供零.