创建 GitHub 拉取请求。
概要
hub pull-request [-focpd] [-b BASE] [-h HEAD] [-r REVIEWERS ] [-a ASSIGNEES] [-M MILESTONE] [-l LABELS]
hub pull-request -m MESSAGE [--edit]
hub pull-request -F FILE [--edit]
hub pull-request -i ISSUE
选项
- -f, --force
跳过检查未推动的提交。
- -m, --message MESSAGE
MESSAGE 中第一个空行的文本将作为拉取请求标题处理，其余内容将以 Markdown 格式作为拉取请求描述。
传入多个
--message时，这些值将在间隔一空行的基础上进行连接。如果未提供
--message或--file，文本编辑器将打开供用户创作标题和描述。- --no-edit
使用该分支上的第一个提交中的消息作为拉取请求标题和描述，无需打开文本编辑器。
- -F, --file FILE
从 FILE 中读取拉取请求标题和描述。传入“ -”从标准输入中读取。有关格式化规则，请参见
--message。- -e, --edit
在提交之前使用文本编辑器打开拉取请求标题和描述。这可以与
--message或--file结合使用。- -i, --issue ISSUE
将 ISSUE（通过其编号引用）转换为拉取请求。
你只能转换由你创作或你拥有管理员权限的问题。在大多数工作流中，无需将问题转换为拉取请求。你可在新建拉取请求的正文中引用原始问题。
- -o, --browse
在网页浏览器中打开新的拉取请求。
- -c, --copy
将新拉取请求的 URL 复制到剪贴板，而不是打印它。
- -p, --push
在创建拉取请求之前将当前分支推送到 HEAD。
- -b, --base BASE
基本分支的格式为 “[OWNER:]BRANCH”。默认为上游仓库的默认分支（通常为“master”）。
有关 hub 在存在多个 git 远程时如何选择默认值的更多信息，请参阅 hub(1) 的“约定”部分。
- -h, --head HEAD
“[OWNER:]BRANCH”格式的头分支。默认为当前签出的分支。
- -r, --reviewer USERS
一个以逗号分隔的（逗号周围没有空格）请求审核的 GitHub 处理列表。
- -a, --assign USERS
一个以逗号分隔的（逗号周围没有空格）应分配给此请求的 GitHub 处理列表。
- -M, --milestone NAME
应添加到此请求中的里程碑名称。已弃用传递里程碑编号。
- -l, --labels LABELS
一个以逗号分隔的（逗号周围没有空格）应添加到此请求的标签列表。如果标签不存在，将创建它们。
- -d, --draft
将请求创建为草稿。
- --no-maintainer-edits
从 fork 创建请求时，此操作会禁止项目维护者推送至该 fork 的头分支。默认允许维护者编辑。
示例
$ hub pull-request
[ opens a text editor for writing title and message ]
[ creates a pull request for the current branch ]
$ hub pull-request --base OWNER:master --head MYUSER:my-branch
[ creates a pull request with explicit base and head branches ]
$ hub pull-request --browse -m "My title"
[ creates a pull request with the given title and opens it in a browser ]
$ hub pull-request -F - --edit < path/to/message-template.md
[ further edit the title and message received on standard input ]
配置
HUB_RETRY_TIMEOUT- 在
--push上收到 HTTP 422 之后继续重试的最长时间（默认值：9）。