記事のバージョン: Enterprise Server 2.17
Issue およびプルリクエストを検索する
GitHub Enterprise 上の Issue およびプルリクエストを検索することができます。そして、これらの検索用修飾子を組み合わせることで、検索結果を絞ることができます。
ここには以下の内容があります:
- Issue またはプルリクエストに限定した検索
- タイトル、本文、またはコメントで検索
- ユーザまたは Organization のリポジトリ内の検索
- オープンかクローズかで検索
- リポジトリがパブリックかプライベートかで検索
- 作者で検索
- アサインされた人で検索
- メンションで検索
- Team メンションで検索
- コメントした人で検索
- Issue やプルリクエストに関係したユーザで検索
- ラベルで検索
- マイルストーンで検索
- プロジェクトボードで検索
- コミットステータスで検索
- コミット SHA で検索
- ブランチ名で検索
- 言語で検索
- コメントの数で検索
- インタラクションの数で検索
- リアクションの数で検索
- ドラフトプルリクエストを検索
- プルリクエストレビューのステータスおよびレビュー担当者で検索
- Issue やプルリクエストの作成時期や最終更新時期で検索
- Issue やプルリクエストがクローズされた時期で検索
- プルリクエストがマージされた時期で検索
- プルリクエストがマージされているかどうかで検索
- リポジトリがアーカイブされているかどうかで検索
- 会話がロックされているかどうかで検索
- 欠損しているメタデータで検索
- 参考リンク
GitHub Enterprise 全体にわたってグローバルに Issue およびプルリクエストを検索できます。あるいは、特定の Organization の Issue およびプルリクエストに限った検索もできます。 詳細は「GitHub での検索について」を参照してください。
参考:
-
この記事には、GitHub.com のウェブサイトでの検索例が含まれています。ですが、同じ検索フィルターを GitHub Enterprise Server インスタンス で使えます。
-
検索結果を改良する検索修飾子を追加できる検索構文のリストについては、「検索構文を理解する」を参照してください。
-
複数単語の検索用語は引用符で囲みます。 たとえば "In progress" というラベルを持つ Issue を検索したい場合は、
label:"in progress"
とします。 検索では、大文字と小文字は区別されません。 -
キーボードショートカットを使えば、Issueあるいはプルリクエストのリストの上にある検索バー上のカーソルに集中できます。 詳細は「キーボードのショートカット」を参照してください。
Issue またはプルリクエストに限定した検索
デフォルトでは、GitHub Enterprise の検索は、Issueとプルリクエストの両方を結果表示します。 ですが、type
修飾子または is
修飾子を使うことで、Issue またはプルリクエストに限った検索ができます。
修飾子 | サンプル |
---|---|
type:pr | cat type:pr は、「cat」という単語があるプルリクエストにマッチします。 |
type:issue | github commenter:defunkt type:issue は、「github」という単語を含み、かつ、@defunkt によるコメントがある Issue にマッチします。 |
is:pr | event is:pr は、「event」という単語があるプルリクエストにマッチします。 |
is:issue | is:issue label:bug is:closed は、「bug」のラベルが付いたクローズされた Issue にマッチします。 |
タイトル、本文、またはコメントで検索
in
修飾子によって、タイトル、本文、コメントやその組み合わせに限定した検索ができます。 この修飾子を省略した場合、タイトル、本文、そしてコメントがすべて検索されます。
修飾子 | サンプル |
---|---|
in:title | warning in:title は、タイトルに「warning」を含む Issue にマッチします。 |
in:body | error in:title,body は、タイトルか本文に「error」を含む Issue にマッチします。 |
in:comments | shipit in:comments は、コメントで「shipit」にメンションしている Issue にマッチします。 |
ユーザまたは Organization のリポジトリ内の検索
特定のユーザーや Organization が保有するすべてのリポジトリの Issue とプルリクエストを検索するには、 user
修飾子または org
修飾子を使います。 特定のリポジトリの Issue やプルリクエストを検索するには、repo
修飾子を使います。
修飾子 | サンプル |
---|---|
user:USERNAME | user:defunkt ubuntu は、@defunkt が保有するリポジトリからの「ubuntu」という単語がある Issue にマッチします。 |
org:ORGNAME | org:github は、GitHub Organization が保有するリポジトリの Issue にマッチします。 |
repo:USERNAME/REPOSITORY | repo:mozilla/shumway created:<2012-03-01 は、2012 年 3 月より前に作成された @mozilla の shumway プロジェクトからの Issue にマッチします。 |
オープンかクローズかで検索
state
修飾子または is
修飾子を使って、オープンかクローズかで、Issue およびプルリクエストをフィルタリングできます。
修飾子 | サンプル |
---|---|
state:open | libraries state:open mentions:vmg は、「libraries」という単語がある @vmg にメンションしているオープン Issue にマッチします。 |
state:closed | design state:closed in:body は、本文に「design」という単語がある、クローズされた Issue にマッチします。 |
is:open | performance is:open is:issue は、「performance」という単語があるオープン Issue にマッチします。 |
is:closed | android is:closed は、「android」という単語があるクローズされた Issue とプルリクエストにマッチします。 |
リポジトリがパブリックかプライベートかで検索
GitHub Enterprise のすべてにわたって検索する場合、リポジトリがパブリックかプライベートかでフィルタリングすると便利です。 is:public
および is:private
を使用して、これができます。
修飾子 | サンプル |
---|---|
is:public | is:public は、すべてのパブリックなリポジトリの Issue とプルリクエストにマッチします。 |
is:private | is:private cupcake は、あなたがアクセスできるプライベートなリポジトリにある「cupcake」という単語を含む Issue およびプルリクエストにマッチします。 |
作者で検索
author
修飾子によって、特定のユーザまたはインテグレーションアカウントが作成した Issue およびプルリクエストを検索できます。
修飾子 | サンプル |
---|---|
author:USERNAME | cool author:gjtorikianは、@gjtorikian が作成した「cool」という単語がある Issue とプルリクエストにマッチします。 |
bootstrap in:body author:mdo は、本文に「bootstrap」という単語を含む @mdo が作成した Issue にマッチします。 | |
author:app/USERNAME | author:app/robot は、「robot」というインテグレーションアカウントが作成した Issue にマッチします。 |
アサインされた人で検索
assignee
修飾子は、特定のユーザにアサインされた Issue およびプルリクエストを表示します。 アサインされた人がいる Issue およびプルリクエストは、一切検索できません。 アサインされた人がいない Issue およびプルリクエストは、検索できます。
修飾子 | サンプル |
---|---|
assignee:USERNAME | assignee:vmg repo:libgit2/libgit2 は、@vmg にアサインされた libgit2 のプロジェクト libgit2 の Issue およびプルリクエストにマッチします。 |
メンションで検索
mentions
修飾子は、特定のユーザーにメンションしている Issue を表示します。 詳細は「人およびチームにメンションする」を参照してください。
修飾子 | サンプル |
---|---|
mentions:USERNAME | resque mentions:defunkt は、@defunkt にメンションしている「resque」という単語がある Issue にマッチします。 |
Team メンションで検索
あなたが属する Organization および Team について、 team
修飾子により、Organization 内の一定の Team に @メンションしている Issue またはプルリクエストを表示します。 検索を行うには、これらのサンプルの名前をあなたの Organization および Team の名前に置き換えてください。
修飾子 | サンプル |
---|---|
team:ORGNAME/TEAMNAME | team:jekyll/owners は、@jekyll/owners Team がメンションされている Issue にマッチします。 |
team:myorg/ops is:open is:pr は、@myorg/ops Team がメンションされているオープンなプルリクエストにマッチします。 |
コメントした人で検索
commenter
修飾子は、特定のユーザからのコメントを含む Issue を検索します。
修飾子 | サンプル |
---|---|
commenter:USERNAME | github commenter:defunkt org:github は、@defunkt のコメントがあり、「github」という単語がある、GitHub が所有するリポジトリの Issue にマッチします。 |
Issue やプルリクエストに関係したユーザで検索
involves
修飾子は、特定のユーザが何らかの方法で関与する Issue を表示します。 involves
修飾子は、単一ユーザについて、author
、assignee
、mentions
、および commenter
を論理 OR でつなげます。 言い換えれば、この修飾子は、特定のユーザが作成した、当該ユーザにアサインされた、当該ユーザをメンションした、または、当該ユーザがコメントした、Issue およびプルリクエストを表示します。
修飾子 | サンプル |
---|---|
involves:USERNAME | involves:defunkt involves:jlord は、@defunkt または @jlord が関与している Issue にマッチします。 |
NOT bootstrap in:body involves:mdoは、本文に「bootstrap」という単語を含まず、@mdo が関与している Issue にマッチします。 |
ラベルで検索
label
修飾子を使って、ラベルで検索結果を絞り込むことができます。 Issue は複数のラベルがある可能性があることから、各 Issue について異なる修飾子を記載できます。
修飾子 | サンプル |
---|---|
label:LABEL | label:"help wanted" language:ruby は、Ruby のリポジトリにある「help wanted」のラベルがある Issue にマッチします。 |
broken in:body -label:bug label:priority matches issues with the word "broken" in the body, that lack the label "bug", but do have the label "priority." | |
label:bug label:resolved は、「bug」および「resolved」というラベルがある Issue にマッチします。 |
マイルストーンで検索
milestone
修飾子は、リポジトリ内のマイルストーンの一部である Issue またはプルリクエストを表示します。
修飾子 | サンプル |
---|---|
milestone:MILESTONE | milestone:"overhaul"は、「overhaul」という名前のマイルストーンにある Issue にマッチします。 |
milestone:"bug fix"は、「bug fix」という名前のマイルストーンにある Issue にマッチします。 |
プロジェクトボードで検索
リポジトリまたは Organization にある特定のプロジェクトボードと関連する Issue を表示するには、project
修飾子を使います。 プロジェクトボードはプロジェクトボード番号で検索する必要があります。 プロジェクトボードの URL の末尾に、プロジェクトボード番号が表示されています。
修飾子 | サンプル |
---|---|
project:PROJECT_BOARD | project:github/57 は、Organization のプロジェクトボード 57 に関連付けられている、GitHub が所有する Issue にマッチします。 |
project:REPOSITORY/PROJECT_BOARD | project:github/linguist/1 は、@github の Linguist リポジトリのプロジェクトボード 1 に関連付けられている Issue にマッチします。 |
コミットステータスで検索
コミットのステータスでプルリクエストをフィルタリングできます。 ステータス API または CI サービスを使っている場合、特に役立ちます。
修飾子 | サンプル |
---|---|
status:pending | language:go status:pending は、ステータスが pending になっている Go リポジトリにオープンしたプルリクエストにマッチします。 |
status:success | is:open status:success finally in:body は、ステータスが successful になっている body に「finally」という単語があるオープンなプルリクエストにマッチします。 |
status:failure | created:2015-05-01..2015-05-30 status:failure は、ステータスが failed になっている 2015 年 5 月にオープンしたプルリクエストにマッチします。 |
コミット SHA で検索
コミットの特定の SHA ハッシュを知っている場合、その SHA を含むプルリクエストを検索するために使えます。 SHA の構文は、7 字以上であることが必要です。
修飾子 | サンプル |
---|---|
SHA | e1109ab は、e1109ab で始まるコミット SHA のプルリクエストにマッチします。 |
0eff326d6213c is:merged は、0eff326d6213c で始まるコミット SHA のマージされたプルリクエストにマッチします。 |
ブランチ名で検索
元のブランチ (「head」ブランチ) またはマージされるブランチ (「base」ブランチ) でプルリクエストをフィルタリングできます。
修飾子 | サンプル |
---|---|
head:HEAD_BRANCH | head:change is:closed is:unmerged は、クローズされた「change」という単語から始まる名前のブランチから開かれたプルリクエストに一致します。 |
base:BASE_BRANCH | base:gh-pages は、gh-pages ブランチにマージされるプルリクエストにマッチします。 |
言語で検索
language
修飾子により、特定の言語で記述されたリポジトリ内の Issue およびプルリクエストを検索できます。
修飾子 | サンプル |
---|---|
language:LANGUAGE | language:ruby state:open は、Ruby のリポジトリにあるオープン Issue にマッチします。 |
コメントの数で検索
コメントの数で検索するには、不等号や範囲の修飾子とともに comments
修飾子を使います。
修飾子 | サンプル |
---|---|
comments:n | state:closed comments:>100は、コメント数が 100 を超えるクローズした Issue にマッチします。 |
comments:500..1000は、500 から 1,000 までの範囲のコメント数の Issue にマッチします。 |
インタラクションの数で検索
interactions
修飾子と不等号や範囲の修飾子を使って、Issue や プルリクエストをインタラクションの数でフィルタリングできます。 インタラクションの数とは、1 つの Issue またはプルリクエストにあるリアクションおよびコメントの数のことです。
修飾子 | サンプル |
---|---|
interactions:n | interactions:>2000 は、インタラクションの数が 2,000 を超えるプルリクエストまたは Issue にマッチします。 |
interactions:500..1000 は、インタラクションの数が 500 から 1,000 までの範囲のプルリクエストまたは Issue にマッチします。 |
リアクションの数で検索
reactions
修飾子と不等号や範囲の修飾子を使って、Issue や プルリクエストをリアクションの数でフィルタリングできます。
修飾子 | サンプル |
---|---|
reactions:n | reactions:>1000 は、リアクションの数が 1,000 を超える Issue にマッチします。 |
reactions:500..1000 は、リアクションの数が 500 から 1,000 までの範囲の Issue にマッチします。 |
ドラフトプルリクエストを検索
ドラフトプルリクエストをフィルタリングすることができます。 詳しい情報についてはプルリクエストについてを参照してください。
| Qualifier | Example | ------------- | ------------- | is:draft
| is:draft はドラフトプルリクエストに一致します。
プルリクエストレビューのステータスおよびレビュー担当者で検索
You can filter pull requests based on their review status (none, required, approved, or changes requested), by reviewer, and by requested reviewer.
修飾子 | サンプル |
---|---|
review:none | type:pr review:none は、レビューされていないプルリクエストにマッチします。 |
review:required | type:pr review:required は、マージ前にレビューが必要なプルリクエストにマッチします。 |
review:approved | type:pr review:approved は、レビュー担当者が承認したプルリクエストにマッチします。 |
review:changes_requested | type:pr review:changes_requested は、レビュー担当者が変更を求めたプルリクエストにマッチします。 |
reviewed-by:USERNAME | type:pr reviewed-by:gjtorikian は、特定の人がレビューしたプルリクエストにマッチします。 |
review-requested:USERNAME | type:pr review-requested:benbalter は、特定の人にレビューがリクエストされているプルリクエストにマッチします。 リクエストを受けたレビュー担当者は、プルリクエストのレビュー後は検索結果に表示されなくなります。 リクエストされた人物がレビューをリクエストされている Team にいる場合は、その Team のレビューリクエストも検索結果に表示されます。 |
team-review-requested:TEAMNAME | type:pr team-review-requested:atom/design は、Team atom/design からのレビューリクエストがあるプルリクエストにマッチします。 リクエストを受けたレビュー担当者は、プルリクエストのレビュー後は検索結果に表示されなくなります。 |
Issue やプルリクエストの作成時期や最終更新時期で検索
作成時期または最終更新時期で Issue をフィルタリングできます。 Issue の作成時期については、created
の修飾子を使います。Issue の最終更新時期で表示するには、updated
の修飾子を使います。
どちらの修飾子も、パラメータとして日付を使います。 日付の形式は ISO8601標準に従い、YYYY-MM-DD
(年-月-日) とする必要があります。 オプションの時間情報のTHH:MM:SS+00:00
を日付の後に付けて、時、分、秒で検索できるようにすることもできます。 これはT
の後にHH:MM:SS
(時-分-秒)、そしてUTCオフセット(+00:00
)を続けたものです。
日付では大なり、小なりおよび範囲指定を使用できます。
修飾子 | サンプル |
---|---|
created:YYYY-MM-DD | language:c# created:<2011-01-01 state:open matches open issues that were created before 2011 in repositories written in C#. |
updated:YYYY-MM-DD | weird in:body updated:>=2013-02-01 matches issues with the word "weird" in the body that were updated after February 2013. |
Issue やプルリクエストがクローズされた時期で検索
closed
修飾子を使って、Issue およびプルリクエストを、クローズされているかどうかでフィルタリングできます。
この修飾子は、パラメータとして日付を使います。 日付の形式は ISO8601標準に従い、YYYY-MM-DD
(年-月-日) とする必要があります。 オプションの時間情報のTHH:MM:SS+00:00
を日付の後に付けて、時、分、秒で検索できるようにすることもできます。 これはT
の後にHH:MM:SS
(時-分-秒)、そしてUTCオフセット(+00:00
)を続けたものです。
日付では大なり、小なりおよび範囲指定を使用できます。
修飾子 | サンプル |
---|---|
closed:YYYY-MM-DD | language:swift closed:>2014-06-11 matches issues and pull requests in Swift that were closed after June 11, 2014. |
data in:body closed:<2012-10-01 matches issues and pull requests with the word "data" in the body that were closed before October 2012. |
プルリクエストがマージされた時期で検索
merged
修飾子を使って、マージされているかどうかでプルリクエストをフィルタリングできます。
この修飾子は、パラメータとして日付を使います。 日付の形式は ISO8601標準に従い、YYYY-MM-DD
(年-月-日) とする必要があります。 オプションの時間情報のTHH:MM:SS+00:00
を日付の後に付けて、時、分、秒で検索できるようにすることもできます。 これはT
の後にHH:MM:SS
(時-分-秒)、そしてUTCオフセット(+00:00
)を続けたものです。
日付では大なり、小なりおよび範囲指定を使用できます。
修飾子 | サンプル |
---|---|
merged:YYYY-MM-DD | language:javascript merged:<2011-01-01 matches pull requests in JavaScript repositories that were merged before 2011. |
fast in:title language:ruby merged:>=2014-05-01 matches pull requests in Ruby with the word "fast" in the title that were merged after May 2014. |
プルリクエストがマージされているかどうかで検索
is
修飾子を使って、マージされたかどうかでプルリクエストをフィルタリングできます。
修飾子 | サンプル |
---|---|
is:merged | bugfix is:pr is:merged は、「bugfix」という単語がある、マージされたプルリクエストにマッチします。 |
is:unmerged | error is:unmerged は、「error」という単語がある、クローズされた Issue およびプルリクエストにマッチします。 |
リポジトリがアーカイブされているかどうかで検索
archived
修飾子は、Issue またはプルリクエストがアーカイブされたリポジトリにあるかどうかでフィルタリングできます。
修飾子 | サンプル |
---|---|
archived:true | archived:true GNOME は、アクセスできるアーカイブされたリポジトリの、「GNOME」という単語を含む Issue およびプルリクエストにマッチします。 |
archived:false | archived:false GNOME は、アクセスできるアーカイブされていないリポジトリの、「GNOME」という単語を含む Issue およびプルリクエストにマッチします。 |
会話がロックされているかどうかで検索
is
修飾子を使用して、ロックされている会話がある Issue またはプルリクエストを検索することができます。 詳細は「会話をロックする」を参照してください。
修飾子 | サンプル |
---|---|
is:locked | code of conduct is:locked is:issue archived:false は、アーカイブされていないリポジトリにロックされている会話がある、「code of conduct」という言葉を含む Issue またはプルリクエストにマッチします。 |
is:unlocked | code of conduct is:unlocked is:issue archived:false は、アーカイブされていないリポジトリにアンロックされている会話がある、「code of conduct」という言葉を含む Issue またはプルリクエストにマッチします。 |
欠損しているメタデータで検索
no
修飾子を使って、一定のメタデータがない Issue およびプルリクエストに検索を絞り込むことができます。 こうしたメタデータには、以下のようなものがあります:
- ラベル
- マイルストーン
- アサインされた人
- プロジェクト
修飾子 | サンプル |
---|---|
no:label | priority no:label は、ラベルのない、「priority」という単語がある Issue およびプルリクエストにマッチします。 |
no:milestone | sprint no:milestone type:issue は、「sprint」という単語を含む、マイルストーンと関連のない Issue にマッチします。 |
no:assignee | important no:assignee language:java type:issue は、Java のリポジトリにある、「important」という単語を含む、アサインされた人とは関連付けられていない Issue にマッチします。 |
no:project | build no:project は、「build」という単語を含む、プロジェクトボードとは関連付けられていない Issue にマッチします。 |