Writing Plugins

自分で作ったプラグインをロードするには <tt>~/.termtter/plugins</tt> ディレクトリにファイルを配置し、
設定ファイル <tt>~/.termtter/config</tt> に以下のような設定を追加します。

<pre><code>...
Termtter::Client.init do |t|
  ...
  t.plug 'my_plugin'
  ...
end
...</code></pre>

h3. Command

fib コマンドの例:

コマンドの登録には <tt>Termtter::Client.register_command</tt> メソッドを使います。

<pre><code>Termtter::Client.register_command(
  :name => :fib,
  :exec => lambda {|arg|
    n = arg.to_i
    text = "fib(#{n}) = #{fib n}"
    Termtter::API.twitter.update(text)
    puts "=> " << text
  }
)</code></pre>

h3. Hook

update コマンドで ERB を使えるようにするためのフックの例:

フックの登録には <tt>Termtter::Client.register_hook</tt> メソッドを使います。

<pre><code>require 'erb'

Termtter::Client.register_hook(
  :name => :erb,
  :point => :modify_arg_for_update,
  :exec => lambda {|cmd, arg|
    ERB.new(arg).result(binding)
  }
)</code></pre>

h3. Filter

protected にしているユーザーを非表示にするためのフィルタの例:

フィルタはフックの一種です。普通のフックと同じように <tt>Termtter::Client.register_hook</tt> メソッドで登録します。

<pre><code>Termtter::Client.register_hook(
  :name => :protected_filter,
  :point => :filter_for_output,
  :exec => lambda { |statuses, event|
    statuses.select { |s| !s.user.protected }
  }
)</code></pre>