Ruby - Easy retry handling
Ruby
#3 Compare This branch is 4 commits ahead of lurker:master.

README.rdoc

retry-handler

easy retry handling

What is this

このライブラリは失敗した時にN回リトライするという処理を簡単に記述することが出来るモジュールです。

Proc.new{
  # なんかエラーの起こるコード
}.retry(:max => 3, :accept_exception => StandardError)

とか書いておくとなんかProc内で例外(この場合はStandardErrorなので、ほとんどの例外が対象)が発生した時最大3回まで、 Procのコードをリトライしてくれるというのが簡単にかける。

また:waitというオプションがあり、これ指定するとエラーがあったとき、3秒間waitのあと、次の試行してくれるようになる。 retry-handler自体の処理の流れを可視化したいときは:loggerオプションを付加すると良い。

lambda{}.retry(:max => 3, :wait => 3)
lambda{}.retry(:max => 3, :wait => 3, :logger => Logger.new(STDERR)

ちなみにProc.newと書くのがダサいときは、lambdaでもbegin-endでも使える

lambda{}.retry(:max => 3)

begin
end.retry(:max => 3)

Method#retryの使い方

たとえばFile.readをretryableにするコード例です

File.method(:read).retry("./not_found.txt", :accept_exception => StandardError, :logger => Logger.new(STDERR))

How to Install

Works on Ruby1.8/1.9

gem install retry-handler

Author

lurker(kimoto)