subelsky_power_tools 1.0.0 → 1.0.1

data/lib/subelsky_power_tools/ext/kernel.rb

@@ -0,0 +1,24 @@
+# API inspired by http://blog.codefront.net/2008/01/14/retrying-code-blocks-in-ruby-on-exceptions-whatever/
+
+module Kernel
+  def retryable(options = {})
+    opts = { :tries => 1, :on => [StandardError] }.merge(options)
+    tries = opts[:tries]
+
+    exceptions = opts[:on]
+    count = 0
+    sleep_seconds = opts[:sleep] || 0
+
+    begin
+      count += 1
+      yield
+    rescue *exceptions => e
+      if count < tries
+        Kernel.sleep(sleep_seconds)
+        retry
+      else
+        raise e
+      end
+    end
+  end
+end

data/lib/subelsky_power_tools/version.rb

@@ -1,3 +1,3 @@
 module SubelskyPowerTools
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/spec/kernel_spec.rb

@@ -0,0 +1,50 @@
+require "spec_helper"
+require "subelsky_power_tools/ext/kernel"
+
+describe "Kernel#retryable" do
+  it "retries exceptions for the specified number of times" do
+    count = 0
+
+    begin
+      retryable(tries: 3) do
+        count += 1
+        raise ArgumentError
+      end
+    rescue ArgumentError
+    end
+
+    count.should == 3
+  end
+
+  it "reraises exceptions after exhausting all tries" do
+    expect {
+      retryable(tries: 2) { raise ArgumentError }
+    }.to raise_error(ArgumentError)
+  end
+
+  it "waits specified number of seconds between tries" do
+    # this seems like a better way to measure sleep than using the clock
+    Kernel.should_receive(:sleep).with(0.2).exactly(2).times
+
+    begin
+      retryable(tries: 3,sleep: 0.2) { raise ArgumentError }
+    rescue ArgumentError
+    end
+
+  end
+
+  it "only retries given exceptions" do
+    expect {
+      retryable(tries: 2,on: ScriptError) { raise ZeroDivisionError }
+    }.to raise_error(ZeroDivisionError)
+  end
+
+  it "returns result of operation if it ultimately succeeds" do
+    result = retryable do
+      49
+    end
+
+    result.should == 49
+  end
+
+end

data/spec/spec_helper.rb

@@ -28,4 +28,5 @@ Spork.prefork do
 end
 
 Spork.each_run do
+  #load "subelsky_power_tools/ext/kernel.rb"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: subelsky_power_tools
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-07-05 00:00:00.000000000 -04:00
+date: 2011-08-01 00:00:00.000000000 -04:00
 default_executable: 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2157564940 !ruby/object:Gem::Requirement
+  requirement: &2153319800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,7 +22,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2157564940
+  version_requirements: *2153319800
 description: ! "This is a collection of Ruby extensions and utilities I've been carting
   around from project to project. \nMany are taken from the Facets project (I just
   don't want to include that whole gem in my codebases).\n"
@@ -44,9 +44,11 @@ files:
 - lib/subelsky_power_tools.rb
 - lib/subelsky_power_tools/ext/exception.rb
 - lib/subelsky_power_tools/ext/hash.rb
+- lib/subelsky_power_tools/ext/kernel.rb
 - lib/subelsky_power_tools/version.rb
 - spec/exception_spec.rb
 - spec/hash_spec.rb
+- spec/kernel_spec.rb
 - spec/spec_helper.rb
 - subelsky_power_tools.gemspec
 has_rdoc: true
@@ -80,4 +82,5 @@ summary: This is a collection of Ruby extensions and utilities I've been carting
 test_files:
 - spec/exception_spec.rb
 - spec/hash_spec.rb
+- spec/kernel_spec.rb
 - spec/spec_helper.rb