Hubot | core scripts から学ぶ Hubot で出来ること

概要

core scripts から、Hubot で出来ることを学びます

Hubot インストール時に付属している、 core scripts から
Hubot でどんなことが出来るのかを学びます。

※これらはあくまで典型例であり、Hubotでできることの範囲はとても広大だと思います

最もオーソドックスな用途。
core scripts の例は以下。

script	処理内容	ソースコード
ping	PONGを返却	ping.coffee
the rules	ロボットの3原則を返却	rules.coffee

core scripts の例は以下。

script	処理内容	ソースコード
pug me	http://pugme.herokuapp.com から取得したパグ画像のURLを返却	pugme.coffee
pug bomb N	http://pugme.herokuapp.com パグ画像のURLをN件返却	pugme.coffee
animate me <query>	queryの条件に応じたアニメーションGIFを返却する	google-images.coffee
youtube me <query>	queryの条件に応じた youtube の動画URLを返却する	youtube.coffee

など。

単発のメッセージではなく、何かしらデータを保持する機能は robot.brain を利用する。

core scripts の例は以下。

script	処理内容	ソースコード
<user> is a <role>	ユーザーに role を割り当てる。設定した値は robot brain に保存される	roles.coffee
<user> is not <role>	ユーザーに role を解除する。設定した値は robot brain から削除される	roles.coffee
who is <user>	指定ユーザーに割り当てられている role を全て表示する	roles.coffee

Hubotサーバーに対して何かしらの操作をしたり、サーバーの情報を取得する。

script	処理内容	ソースコード
die	Hubot 自身プロセスを終了する	ping.coffee
time	サーバー時間を返却する	ping.coffee

上述の画像や動画の取得も内部的にはこの形式を利用している。

script	処理内容	ソースコード
image me <query>	queryの条件に応じた画像を google API で取得し、URLを返却する	google-images.coffee
animate me <query>	queryの条件に応じたアニメーション画像を google API で取得し、URLを返却する	google-images.coffee
map me <query>	queryの条件に応じたアニメーション画像を google API で取得し、URLを返却する	maps.coffee
mustache me <query>	queryの条件に応じた髭の画像を http://mustachify.me/ から取得し、URLを返却する	google-images.coffee

Hubotサーバーに対して何かしらの操作をしたり、サーバーの情報を取得する。

script	処理内容	ソースコード
show storage	hubot.brainの内容	storage.coffee
show users	Hubotが把握しているユーザーの一覧	storage.coffee

など。