retry with steroids
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

retry_upto: retry with steroids

If you need to use retry in ruby, you probably want to retry some code only a maximum number of times, and sometimes wait an interval of time between the attempts to avoid external resources hiccups or usage limits.

Therefore Your Important Code ends surrounded by counters, conditions and calls to sleep.

This gem deals elegantly with this common scenario:

retry_upto(5) do
  # Your Important Code

Under Ruby 1.9 it also allows:

5.times.retry do
  # Your Important Code

Keep reading to see all the options available.


Basic usage

Retries up to 5 times catching any exception, doesn't wait between attempts:


Time intervals between attempts

For fixed intervals, an :interval parameter can be passed indicating the time in seconds. The following example will sleep two seconds between attempts:

retry_upto(5, :interval => 2)

For customized intervals, the :interval parameter can be a lambda, which will be applied to the number of each attempt. For instance, the following code will sleep 3 seconds after the first attempt, 6 after the second, 9 after the third...

retry_upto(5, :interval => lambda{ |attempt| attempt * 3 })

Retrying only when certain Exceptions get raised

Retries up to 5 times only after a ZeroDivisionError, raising any other Exception:

retry_upto(5, :rescue => ZeroDivisionError)

Retries up to 5 times only after a ZeroDivisionError or a NameError, raising any other Exception:

retry_upto(5, :rescue => [ZeroDivisionError, NameError])

All the options described above can be combined together.

More sugar!

In ruby 1.9, the Enumerator class gets enhanced to use retry_upto this way:


This syntax accepts the same options:

5.times.retry(:interval => 10)


See the LICENSE file included in the distribution.


This gem was born from gists by Raul Murciano, Glenn Gillen, Pedro Belo, Jaime Iniesta, Lleïr Borras and ideas taken from Aitor García Rey and Jim Remsik.

Yes, so many brain cells and so few lines of code. Great, isn't it?