gh search prs
gh search prs [<query>] [flags]
在 GitHub 上搜索拉取请求。
该命令支持使用 GitHub 搜索语法、使用参数和限定符标志或两者的组合来构建查询。
GitHub 搜索语法记录在:https://docs.github.com/search-github/searching-on-github/searching-issues-and-pull-requests
选项
-
--app <string> - 按 GitHub App 作者过滤
-
--archived - 根据存储库存档状态进行过滤 {true|false}
-
--assignee <string> - 按指派人过滤
-
--author <string> - 按作者过滤
-B,--base <string>- 按基线分支名称过滤
-
--checks <string> - 根据检查状态进行过滤:{pending|success|failure}
-
--closed <date> - 按关闭日期过滤
-
--commenter <user> - 根据用户评论进行过滤
-
--comments <number> - 按评论数量过滤
-
--created <date> - 根据创建日期进行过滤
-
--draft - 根据草稿状态进行过滤
-H,--head <string>- 按头部分支名称过滤
-
--interactions <number> - 按反应和评论的数量过滤
-
--involves <user> - 根据用户的参与进行过滤
-q,--jq <expression>- 使用 jq 表达式过滤 JSON 输出
-
--json <fields> - 使用指定的字段输出 JSON
-
--label <strings> - 按标签过滤
-
--language <string> - 根据编码语言进行过滤
-L,--limit <int> (default 30)- 要获取的最大结果数
-
--locked - 按锁定对话状态过滤
-
--match <strings> - 将搜索限制到问题的特定字段:{title|body|comments}
-
--mentions <user> - 根据用户提及进行过滤
-
--merged - 根据合并状态进行过滤
-
--merged-at <date> - 按合并日期过滤
-
--milestone <title> - 按里程碑标题过滤
-
--no-assignee - 按缺少指派人过滤
-
--no-label - 按缺少标签过滤
-
--no-milestone - 按缺少里程碑过滤
-
--no-project - 按缺少项目过滤
-
--order <string> (default "desc") - 返回结果的顺序,除非指定了 '--sort' 标志,否则将被忽略:{asc|desc}
-
--owner <strings> - 按存储库所有者过滤
-
--project <number> - 按项目看板编号过滤
-
--reactions <number> - 按反应数量过滤
-R,--repo <strings>- 按存储库过滤
-
--review <string> - 根据审查状态进行过滤:{none|required|approved|changes_requested}
-
--review-requested <user> - 按请求审查的用户或团队过滤
-
--reviewed-by <user> - 按审查用户过滤
-
--sort <string> (default "best-match") - 对获取的结果进行排序:{comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-tada|interactions|created|updated}
-
--state <string> - 根据状态进行过滤:{open|closed}
-
--team-mentions <string> - 根据团队提及进行过滤
-t,--template <string>- 使用 Go 模板格式化 JSON 输出;请参阅“gh help formatting”
-
--updated <date> - 按上次更新日期过滤
-
--visibility <strings> - 根据存储库可见性进行过滤:{public|private|internal}
-w,--web- 在网络浏览器中打开搜索查询
JSON 字段
assignees, author, authorAssociation, body, closedAt, commentsCount, createdAt, id, isDraft, isLocked, isPullRequest, labels, number, repository, state, title, updatedAt, url
示例
# search pull requests matching set of keywords "fix" and "bug"
$ gh search prs fix bug
# search draft pull requests in cli repository
$ gh search prs --repo=cli/cli --draft
# search open pull requests requesting your review
$ gh search prs --review-requested=@me --state=open
# search merged pull requests assigned to yourself
$ gh search prs --assignee=@me --merged
# search pull requests with numerous reactions
$ gh search prs --reactions=">100"
# search pull requests without label "bug"
$ gh search prs -- -label:bug
# search pull requests only from un-archived repositories (default is all repositories)
$ gh search prs --owner github --archived=false