Streamのクエリ
Streamには柔軟なクエリを指定することができます。ここではよく使われるクエリを紹介します。
オープン状態のissue
オープン(クローズやマージされていない)状態のissueを見るStreamを作るにはis:open
を使います。たとえばnodejs/node
リポジトリのオープンなissueを見るには次のクエリでStreamを作成します。
しかし、Jasperではis:open
を使ったStreamを作ることは非推奨です。なぜなら、オープン状態のissueがクローズされたときにJasperではクローズの検知ができないためです。
これはJasperがGitHub Search APIをポーリングしていることによる制約です
そのためis:open
を使う場合は通常のStreamではなく、Filter Streamを使うようにしてください。Filter Streamは通常のStreamに対してJasper独自のフィルターをかけることができます。先程の例は次のようになります。
Stream
Filter Stream
Filter Streamについてはリファレンスの「Filter Stream」を参照してください。
クローズ状態、マージ状態、ドラフト状態についても同様の制限があります。
Teamメンションされたissue
Teamメンションされたissueを見るにはteam:ORGNAME/TEAMNAME
を使います。例えば@jekyll/owners
がメンションされたissueを見るには次のようなクエリでStreamを作成します。
GitHub Docs: Search by team mention
ユーザが関係するissue
特定のユーザが関係するissueを見るにはinvolves:USERNAME
を使います。例えばdefunkt
もしくはjlord
が関係するissueを見るには次のようなクエリでStreamを作成します。
involves:USERNAME
はauthor, assign, mention, comment, review-requestedをまとめて指定することができる便利なクエリです。
GitHub Docs: Search by a user that's involved in an issue or pull request
リポジトリやOrganizationのissue
特定のリポジトリのissueを見るにはrepo:USERNAME/REPOSITORY
を使います。例えばnodejs/node
もしくはelectron/electron
リポジトリのissueを見るには次のようなクエリでStreamを作成します。
特定のOrganizationのissueを見るにはorg:ORGNAME
を使います。例えばnodejs
やelectron
Organizationのissueを見るには次のようなクエリでStreamを作成します。
GitHub Docs: Search within a user's or organization's repositories
マイルストーンやラベルがついたissue
特定のマイルストーンが付いたissueを見るにはmilestone:MILESTONE_NAME
を使います。例えばnodejs/node
リポジトリで13.0.0
もしくは14.0.0
のマイルストーンがついたissueを見るには次のようなクエリでStreamを作成します。
特定のラベルが付いたissueを見るにはlabel:LABEL_NAME
を使います。例えばnodejs/node
リポジトリでbuild
とzlib
のラベルが付いたissueを見るには次のようなクエリでStreamを作成します。
複数のラベルを指定するとand条件となります。
スペースを含むマイルストーンやラベルの場合はmilestone:"foo bar"
のように指定してください。
GitHub Docs: Search by milestone, Search by label
キーワードが含まれるissue
特定のキーワードが含まれるissueを見るにはKEYWORDを使います。例えばoctocatとgithubが含まれるissueを見るには次のようなクリエでStreamを作成します。
日本後などのマルチバイト文字やスペースを含むキーワードは"foo bar"
のように指定してください。
GitHub Docs: Limitations on query length, Exclude certain results
除外指定
特定のリポジトリやラベルを含まないように指定するには-QUALIFIER
を使います。例えばnodejs
organizatonでnodejs/node
リポジトリとbug
ラベルを含まいないissueを見るには次のようなクエリでStreamを作成します。
GitHub Docs: Exclude certain results
Last updated