0.02
No commit activity in last 3 years
No release in over 3 years
Runs a code block, and retries it when an exception occurs. Simple as'at.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

>= 0
 Project Readme

This fork is available as a gem under the name 'reretryable'.

Retryable#retryable

Description

Runs a code block, and retries it when an exception occurs. It's great when working with flakey webservices (for example).

It's configured using four optional parameters :tries, :on, :matching and :sleep, and runs the passed block. Should an exception occur, it'll retry for (tries-1) times.

Should the number of retries be reached without success, the last exception will be raised.

Examples

Open an URL, retry up to two times when an OpenURI::HTTPError occurs.

require "retryable"
require "open-uri"

include Retryable

retryable( :tries => 3, :on => OpenURI::HTTPError ) do
  xml = open( "http://example.com/test.xml" ).read
end

Do something, retry up to four times for either ArgumentError or TimeoutError exceptions.

require "retryable"
include Retryable

retryable( :tries => 5, :on => [ ArgumentError, TimeoutError ] ) do
  # some crazy code
end

Do something, retry up to three times for ArgumentError exceptions which smell like "Bacon", but have a nap between tries.

require "retryable"
include Retryable

retryable( :tries => 3, 
           :on => ArgumentError, 
           :matching => /Bacon/,
           :sleep => 3) do

  # some crazy code about bacon
end

Defaults

:tries => 1, :on => Exception, :matching => /.*/, :sleep => 0

Thanks

Many thanks to Chu Yeow for this nifty piece of code. Look, I liked it enough to enhance it a little bit and build a gem from it! :)