为当前存储库管理 GitHub 拉取请求。
概要
hub pr list [-s STATE] [-h HEAD] [-b BASE] [-o SORT_KEY [-^]] [-f FORMAT] [-L LIMIT]
hub pr checkout PR-NUMBER [BRANCH]
hub pr show [-uc] [-f FORMAT] [-h HEAD]
hub pr show [-uc] [-f FORMAT] PR-NUMBER
命令
- list
列出当前存储库中的拉取请求。
- checkout
在新分支中签出拉取请求的头部。
要使用新提交更新拉取请求，请使用
git push。- show
在 Web 浏览器中打开拉取请求页面。如果没有指定 PR-NUMBER，则使用 HEAD 来查找打开的拉取请求，并且默认为当前分支名称。使用
--format，打印有关拉取请求的信息，而不打开它。
选项
- -s, --state STATE
按 STATE 筛选拉取请求。支持的值为：“open”（默认值）、“closed”、“merged”或“all”。
- -h, --head BRANCH
显示从指定头部 BRANCH 启动的拉取请求。“OWNER:BRANCH”格式必须用于来自 fork 的拉取请求。
- -b, --base BRANCH
显示基于指定 BRANCH 的拉取请求。
- -f, --format FORMAT
使用格式 FORMAT 以漂亮的方式打印拉取请求列表（默认值：“%pC%>(8)%i%Creset %t% l%n”）。有关格式中如何使用占位符的一些其他详细信息，请参见 git-log(1) 的“漂亮格式”部分。可用占位符是
%I：拉取请求编号
%i：前缀为“#”的拉取请求编号
%U：此拉取请求的 URL
%S：状态（“open”或“closed”）
%pS：拉取请求状态（“open”、“draft”、“merged”或“closed”）
%sC：根据状态将颜色设置为红色或绿色
%pC：根据拉取请求状态设置颜色
%t：标题
%l：彩色标签
%L：原始逗号分隔标签
%b：正文
%B：基本分支
%sB：基本提交 SHA
%H：头部分支
%sH：头部提交 SHA
%sm：合并提交 SHA
%au：作者的登录名
%as：指派人的逗号分隔列表
%rs：请求的审阅人的逗号分隔列表
%Mn：里程碑编号
%Mt：里程碑标题
%cD：仅创建日期（没有时间）
%cr：创建日期（相对时间）
%ct：创建日期（UNIX 时间戳）
%cI：创建日期（ISO 8601 格式）
%uD：仅更新日期（没有时间）
%ur：更新日期（相对时间）
%ut：更新日期（UNIX 时间戳）
%uI：更新日期（ISO 8601 格式）
%mD：仅合并日期（没有时间）
%mr：合并日期（相对时间）
%mt：合并日期（UNIX 时间戳）
%mI: 已合并日期，ISO 8601 格式
%n: 换行符
%%: 文字 %
- --color[=WHEN]
即使 stdout 不是一个终端，也启用彩色输出。WHEN 可以是“always”（对于
--color来说是默认值）、“never”或“auto”（默认值）。- -o, --sort KEY
按“created”（默认值）、“updated”、“popularity”或“long-running”对显示的拉取请求进行排序。
- -^, --sort-ascending
按升序日期排序，而不是按降序。
- -L, --limit LIMIT
仅显示前 LIMIT 个拉取请求。
- -u, --url
打印拉取请求 URL，而不是将其打开。
- -c, --copy
将拉取请求 URL 放入剪贴板，而不是将其打开。