Skip to content
A thin wrapper for begin + rescue + sleep + retry.
Ruby
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
certs
lib
test
CHANGES
MANIFEST
README
Rakefile
attempt.gemspec

README

== Description
  A thin wrapper for begin + rescue + sleep + retry.

== Installation
  gem install attempt   

== Synopsis
  require 'attempt'
   
  # Attempt to ftp to some host, trying 3 times with 30 seconds between
  # attempts before finally raising an error.
  #
  attempt(3, 30){
    Net::FTP.open(host, user, passwd){ ... }
  }
   
  # Or, do things the long way...
  code = Attempt.new{ |a|
    a.tries    = 3
    a.interval = 30
  }
   
  code.attempt{
    Net::FTP.open(host, user, passwd){ ... }
  }

== Known Bugs
  None that I'm aware of. If you find any bugs, please log them on the
  project page at:

  https://github.com/djberg96/attempt

== Caveats
  Use with caution. Specifically, make sure you aren't inadvertantly
  wrapping code that already performs sleep + retry. Otherwise, you'll
  end up with a series of nested retry's that could take much longer to
  work than you expect. 

  Also, this library uses the timeout library internally, which has some
  known issues. See Future Plans, below.

== Future Plans
  Add the ability to set an absolute maximum number of seconds to prevent
  nested sleep/retry from delaying attempts longer than expected.

  Replace the timeout library with a self selecting pipe if possible.

== Acknowledgements
  This library is partially based on Mark Fowler's 'Attempt' Perl module.

== Warranty
  This package is provided "as is" and without any express or
  implied warranties, including, without limitation, the implied
  warranties of merchantability and fitness for a particular purpose.

== License
  Artistic 2.0

== Copyright
  (C) 2006-2015, Daniel J. Berger
  All Rights Reserved

== Author
  Daniel J. Berger
Something went wrong with that request. Please try again.