reretryable 0.1.0

data/README.markdown

@@ -0,0 +1,68 @@
+This fork is available as a gem under the name 'reretryable'.
+
+# Retryable#retryable
+
+## Description
+
+Runs a code block, and retries it when an exception occurs. It's great when
+working with flakey webservices (for example).
+
+It's configured using four optional parameters `:tries`, `:on`, `:matching` and `:sleep`, and
+runs the passed block. Should an exception occur, it'll retry for (tries-1) times.
+
+Should the number of retries be reached without success, the last exception
+will be raised.
+
+
+## Examples
+
+Open an URL, retry up to two times when an `OpenURI::HTTPError` occurs.
+
+    require "retryable"
+    require "open-uri"
+    
+    include Retryable
+    
+    retryable( :tries => 3, :on => OpenURI::HTTPError ) do
+      xml = open( "http://example.com/test.xml" ).read
+    end
+
+Do _something_, retry up to four times for either `ArgumentError` or 
+`TimeoutError` exceptions.
+
+    require "retryable"
+    include Retryable
+    
+    retryable( :tries => 5, :on => [ ArgumentError, TimeoutError ] ) do
+      # some crazy code
+    end
+    
+    
+    
+Do _something_, retry up to three times for `ArgumentError` exceptions 
+which smell like "Bacon", but have a nap between tries.
+
+    require "retryable"
+    include Retryable
+    
+    retryable( :tries => 3, 
+               :on => ArgumentError, 
+               :matching => /Bacon/,
+               :sleep => 3) do
+
+      # some crazy code about bacon
+    end
+    
+    
+
+
+## Defaults
+
+    :tries => 1, :on => Exception, :matching => /.*/, :sleep => 0
+    
+
+## Thanks
+
+Many thanks to [Chu Yeow for this nifty piece of code](http://blog.codefront.net/2008/01/14/retrying-code-blocks-in-ruby-on-exceptions-whatever/). Look, I liked it
+enough to enhance it a little bit and build a gem from it! :)
+

data/lib/reretryable.rb

@@ -0,0 +1,28 @@
+module Retryable
+  def retryable(options = {}, &block)
+    opts = { :tries     => 1, 
+             :on        => StandardError,
+             :sleep     => 0,
+             :matching  => /.*/ }.merge(options)
+
+    return nil if opts[:tries] == 0
+  
+    retry_exception = [opts[:on]].flatten
+    tries           = opts[:tries]
+    message_pattern = opts[:matching]
+    sleep_time      = opts[:sleep]
+ 
+    begin
+      return yield
+    rescue *retry_exception => exception
+      raise unless exception.message =~ message_pattern
+
+      if (tries -= 1) > 0
+        sleep sleep_time
+        retry
+      end
+    end
+ 
+    yield
+  end
+end

data/reretryable.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{retryable}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Craig 'The Craif' Mackenzie and Niko Felger"]
+  s.date = %q{2010-04-07}
+  s.email = %q{developers@songkick.com}
+  s.extra_rdoc_files = ["README.markdown"]
+  s.files = ["README.markdown", "retryable.gemspec", "spec", "lib/retryable.rb"]
+  s.homepage = %q{http://www.songkick.com}
+  s.rdoc_options = ["--main", "README.markdown"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Retrying code blocks on specific errors}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: reretryable
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Craig 'The Craif' Mackenzie and Niko Felger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-15 00:00:00 +10:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: 
+email: developers@songkick.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- reretryable.gemspec
+- lib/reretryable.rb
+has_rdoc: true
+homepage: http://www.songkick.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: What this thing does
+test_files: []
+