GIT PR分支

git-pr-branch是一个用于管理分支与pull请求之间关系的命令行工具。

目前它仅支持Github和Pagure，但其他后端也是可能的。

如果您计划使用Github（Pagure可以在不使用令牌的情况下工作），则需要在其设置页面创建一个个人令牌您的Github设置页面。当您第一次启动程序时，它会要求您提供它，并将其存储在配置文件中。

克隆仓库

在为新项目做出贡献时，需要克隆仓库，分叉它，然后克隆分叉以上传贡献。可以通过运行：git pr-branch clone https://github.com/project/repo来完成这三个步骤。新创建的分叉的Git远程将被命名为fork。

如果您已经克隆了仓库，只想创建和/或注册您的分叉，可以使用：git pr-branch add-fork。

下载拉取请求

git pr-branch pull 42 将下载编号为42的拉取请求到本地分支，每次运行命令都会创建一个新的分支。为什么这样做呢？因为PR作者在审查后通常会对提交进行修改，而不是添加更多提交，作为审阅者，很难看到你审查的代码和新增代码之间的差异。通过每次创建新分支，你可以仅比较前一个分支。

如果你之前没有检出这个PR，它将为PR历史中的每个现有审查创建一个分支。这样，即使当时没有运行命令，也可以轻松地看到早期审查之间的变化（在Pagure上不支持此行为）。

当你正在处理PR分支时，运行 git pr-branch update 或 git pr-branch up 将下载PR的最新版本到一个新分支并切换到该分支。这是一个快捷操作，因此你无需再次记住和输入PR编号。

显示分支和拉取请求

git pr-branch show 将列出所有本地分支，并显示它们是否与拉取请求关联，该PR是否仍然开放，以及该PR的URL。

清除分支

git pr-branch purge 将删除与已关闭拉取请求（或多个都已关闭的拉取请求）关联的分支。这将帮助你保持本地仓库整洁。

选项

如果你从分叉的远程仓库（这里称为“上游”）的远程名称不是“origin”，你可以使用 -u 或 --upstream 选项设置哪个远程是上游。以下是一个示例：如果Bob想分叉Alice的仓库，他可以先克隆自己的分叉，然后添加Alice的仓库作为远程。

$ git clone git@github.com:/bob/repo
$ git remote add upstream git@github.com:/alice/repo

因此，原始仓库不在默认的 origin 远程，而在 upstream 远程。在此配置中，必须使用带有 -u 选项的 git-pr-branch。

$ git pr-branch -u upstream show

此值将在本地仓库的配置中设置，你以后就不需要使用此选项了。

如果你的大多数本地仓库不使用远程 origin 作为上游，你可以在配置文件中配置不同的默认值。第一次设置“向导”会询问你。

安装

你可以使用以下命令从PyPI安装git-pr-branch

pipx install git-pr-branch

还有一个COPR仓库，为某些发行版提供RPM包。