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