retry 0.0.2 → 0.1.0

data/History.txt

@@ -1,3 +1,8 @@
++++ 0.1.0 2007-06-15
+
++ 1 minor enhancement:
+  + Now supports a timed backoff strategy.
+
 +++ 0.0.1 2007-05-31
 
 + 1 major enhancement:

data/lib/retry.rb

@@ -5,9 +5,11 @@ class Fixnum
 
 =begin rdoc
 - message       => allows you to provide some context to the error messages that get printed out.
-- output_stream =>  allows you to specify to which output stream you want any errors to be written.  Defaults to $stderr
+- output_stream => allows you to specify to which output stream you want any errors to be written.  Defaults to $stderr
+- backoff       => specify a backoff strategy.  Currently this is an array of timeouts, probably escalating like [1,2,4,8].  The array can be as short as you like.  In the previous example if you had ten tries it would just continue to use '8' as the timeout value once it reached the end of the array.
 =end
-  def tries(message = nil, output_stream = $stderr) # :yields: 
+  def tries(message = nil, output_stream = $stderr, backoff_times = []) # :yields:
+    output_stream ||= $stderr # if they pass in nill, still default.
     current_try_num = 1
     begin
       yield current_try_num
@@ -15,11 +17,22 @@ class Fixnum
       if current_try_num >= self
         raise
       else
+        # backoff strategy
+        if backoff_times && backoff_times.respond_to?(:shift) && !backoff_times.empty?
+          @backoff_sleep = backoff_times.shift
+        end
+        Kernel.sleep(@backoff_sleep) if @backoff_sleep
+
+        # user messaging
         m = message ? " (#{message})" : ''
-        output_stream.puts "Try #{current_try_num} failed#{m}: #{e}"
+        s = @backoff_sleep ? ", sleeping for #{@backoff_sleep} seconds" : ''
+        output_stream.puts "Try #{current_try_num} failed#{m}#{s}: #{e}"
+
+        # actual retry code
         current_try_num = current_try_num.next
         retry
       end
     end
   end
+
 end

data/lib/retry/version.rb

@@ -1,8 +1,8 @@
 module Retry #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 0
-    TINY  = 2
+    MINOR = 1
+    TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>Retry Gem</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/retry"; return false'>
       Get Version
-      <a href="http://rubyforge.org/projects/retry" class="numbers">0.0.2</a>
+      <a href="http://rubyforge.org/projects/retry" class="numbers">0.1.0</a>
     </div>
     <h2>What</h2>
 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: retry
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
-date: 2007-06-01 00:00:00 +01:00
+  version: 0.1.0
+date: 2007-06-15 00:00:00 +01:00
 summary: easily retry blocks of code
 require_paths: 
 - lib