Github 的一大特色就是 Pull Request 功能(简写为 PR)。
对于多人合作的项目,该功能简直必不可少。大部分人都是使用 Web 界面(如上图),本文介绍如何在命令行下处理 PR,翻译自 Cédric Beust 的文章。
一、Pull Request 是什么?
Github 官方文档的定义如下。
"Pull Request 是一种通知机制。你修改了他人的代码,将你的修改通知原来的作者,希望他合并你的修改,这就是 Pull Request。"
Pull Request 本质上是一种软件的合作方式,是将涉及不同功能的代码,纳入主干的一种流程。这个过程中,还可以进行讨论、审核和修改代码。
二、Pull Request 的流程
第一步,你需要把别人的代码,克隆到你自己的仓库,Github 的术语叫做 fork。
第二步,在你仓库的修改后的分支上,按下"New pull request"按钮。
这时,会进入一个新页面,有Base 和 Head 两个选项。Base 是你希望提交变更的目标,Head 是目前包含你的变更的那个分支或仓库。
第三步,填写说明,帮助别人理解你的提交,然后按下"create pull request"按钮即可。
PR 创建后,管理者就要决定是否接受该 PR。对于非代码变更(比如文档),单单使用 Web 界面就足够了。但是,对于代码变更,Web 界面可能不够用,需要命令行验证是否可以运行。
三、git am
git am命令用于将一个 patch 文件,合并进入当前代码。
Github 对每个 PR 会自动生成一个 patch 文件。我们下载该文件,合并进本地代码,就可以在本地查看效果了。
$ curl -L http://github.com/cbeust/testng/pull/17.patch | git am
上面代码中,curl的-L参数表示,如果有302跳转,curl会自动跟进。后面网址里面的/cbeust/testng是目标仓库,pull/17表示该仓库收到的第17个 PR。
如果 PR 只包含一个 commit,那么也可以直接下载这个 commit 的 patch 文件。
$ curl https://github.com/sclasen/jcommander/commit/bd770141029f49bcfa2e0d6e6e6282b531e69179.patch | git am
上面代码中,网址里面的/sclasen/jcommander是代码变更所在的那个仓库。
四、创建远程仓库
另一种方法是为 PR 创建一个远程分支,追踪提交者的仓库。
# 创建远程仓库,指向 PR 提交者的仓库 $ git remote add nullin git://github.com/nullin/testng.git # 从该远程仓库拉取代码 $ git fetch nullin # 将该仓库的某个分支合并到当前分支 $ git merge kneath/error-page # 推送到自己的仓库 $ git push origin master
五、cherry-pick
有时,PR 里面包含好几个 commit,但是你只想合并其中的一个或几个。
这时可以使用cherry-pick命令,挑出你感兴趣的 commit。
# 建立远程分支,追踪提交者的仓库 $ git remote add nullin git://github.com/nullin/testng.git # 从该远程仓库拉取代码 $ git fetch nullin # 只将感兴趣的 commit 加入当前代码 $ git cherry-pick commit1 $ git cherry-pick commit2 # 推送到自己的仓库 $ git push origin master
原文链接:https://www.qiquanji.com/post/6825.html
本站声明:网站内容来源于网络,如有侵权,请联系我们,我们将及时处理。
微信扫码关注
更新实时通知