anticipate 0.0.2 → 0.1.0

data/README.rdoc

@@ -20,4 +20,28 @@ Blocks should contain an assertion, i.e. raise a descriptive error if some condi
 
 The first try is attempted immediately, there is no sleep before the first yield.
 
+== Defining your own timings
+
+If lots of your code needs to wait for things to happen, you might consider defining your own timing module, e.g:
+
+  module Timing
+    include Anticipate
+  
+    def very_soon
+      sleeping(0.1).seconds.between_tries.failing_after(10).tries do
+        yield
+      end
+    end
+  
+    def eventually
+      sleeping(2).seconds.between_tries.failing_after(5).tries do
+        yield
+      end
+    end
+  end
+
+...that way you can adjust timing details in one place as the system grows.
+
+== Alternatives
+
 I'm aware of a couple of gems performing the begin-rescue-sleep-retry dance, namely 'retry' and 'attempt'. The aim of this library is to offer more expressive syntax.

data/lib/anticipate.rb

@@ -5,7 +5,7 @@ require 'anticipate/anticipator'
 require 'anticipate/dsl'
 
 module Anticipate
-  VERSION = '0.0.2'
+  VERSION = '0.1.0'
   
   include DSL
 end

data/lib/anticipate/anticipator.rb

@@ -11,7 +11,7 @@ module Anticipate
       begin
         yield
         return
-      rescue => e
+      rescue Exception => e
         if (count += 1) == tries
           raise TimeoutError.new(interval, tries, e)
         end

data/spec/anticipate/anticipator_spec.rb

@@ -10,7 +10,7 @@ module Anticipate
     
     describe "#anticipate" do
       
-      describe "when the block eventually stops raising" do
+      describe "when the block eventually stops raising a StandardError" do
         it "sleeps the given interval between tries" do
           @sleeper.should_receive(:sleep).with(1).exactly(8).times
           tries = 0
@@ -29,6 +29,19 @@ module Anticipate
           }.should_not raise_error
         end
       end
+      
+      describe "when the block eventually stops raising an Exception (that is not a StandardError)" do
+        
+        it "sleeps the given interval between tries" do
+          @sleeper.should_receive(:sleep).with(1).exactly(8).times
+          tries = 0
+          @anticipator.anticipate(1,9) do
+            raise Exception.new unless (tries += 1) == 9
+          end
+          tries.should == 9
+        end
+        
+      end
         
       describe "when the block always raises" do
         describe "when waiting for one second" do        

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: anticipate
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-02 00:00:00.000000000Z
+date: 2013-05-24 00:00:00.000000000 Z
 dependencies: []
 description: Fluent interface for try-rescue-sleep-retry-abort
 email: joshuachisholm@gmail.com
@@ -48,8 +48,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.6
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: anticipate-0.0.2
+summary: anticipate-0.1.0
 test_files: []