retryable 1.3.4 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5e881ef13cb134d2b9e52b3c478e1d1d02e85898
-  data.tar.gz: 76d3a74f41fc44a60d06054760d36206df77304a
+  metadata.gz: 5cc19b6b707fdd02171896378738cffa3c063cc6
+  data.tar.gz: 70efcfedc8895f963c166ed19374653521fb271a
 SHA512:
-  metadata.gz: b5e65752232a6ddcefb4e46d8cf3908eda78db9f8ff40d91f9464d37f7ae98f8585bf90c73b72e326915dcf4cedd2e70cc97e89b33908948491dd736546a9fb6
-  data.tar.gz: 2d1fcbfcc5206dd347aba24a5cdb5c7734881b75080232ad729e53dbf0a7118223176355083ed8d59aea814090065e249fe59bd39b6c72a5ce076bcf7f2afd42
+  metadata.gz: a302e5df64a1923ef5166f01c3d9ca1e70ee76b07ff50ebe03b51e99d1fb7ce9054aa93cb7e84096fedf7f7d38fbf9866873b6354c6fef5a51457cedf00448e3
+  data.tar.gz: d59b938aad7314d2ea885e86945642393ad4f11ce3f80b0fedbb22c120593fef03fe1acdbc81dabef9324b77afa4cc2f1922b4bbf0e0630b892de5514d19e215

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## Retryable 1.3.5 ##
+
+*   New callback option(:exception_cb) to run after an rescued exception is introduced. Thanks @jondruse
+
 ## Retryable 1.3.4 ##
 
 *   Namespace issue has been fixed. Thanks @darkhelmet

data/README.md

@@ -9,7 +9,7 @@ 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`, `:sleep`, `:matching`, `:ensure` and
+It's configured using four optional parameters `:tries`, `:on`, `:sleep`, `:matching`, `:ensure`, `:exception_cb` and
 runs the passed block. Should an exception occur, it'll retry for (n-1) times.
 
 Should the number of retries be reached without success, the last exception
@@ -56,7 +56,7 @@ end
 
 ## Defaults
 
-    :tries => 2, :on => StandardError, :sleep => 1, :matching  => /.*/, :ensure => Proc.new { }
+    :tries => 2, :on => StandardError, :sleep => 1, :matching  => /.*/, :ensure => Proc.new { }, :exception_cb => Proc.new { }
 
 Sleeping
 --------
@@ -89,6 +89,17 @@ retryable do |retries, exception|
 end
 ```
 
+Callback to run after an exception is rescued
+--------
+exception_cb = Proc.new do |exception|
+  ExceptionNotifier.notify_exception(exception, :data => {:message => "it failed"}) # http://smartinez87.github.io/exception_notification
+end
+
+retryable(:exception_cb => exception_cb) do
+  # perform risky operation
+end
+
+
 You can temporary disable retryable blocks
 --------
 

data/lib/retryable.rb

@@ -3,7 +3,7 @@ require 'retryable/config'
 
 module Kernel
   def retryable(options = {}, &block)
-    opts = {:tries => 2, :sleep => 1, :on => StandardError, :matching  => /.*/, :ensure => Proc.new {}}
+    opts = {:tries => 2, :sleep => 1, :on => StandardError, :matching  => /.*/, :ensure => Proc.new {}, :exception_cb => Proc.new {}}
     check_for_invalid_options(options, opts)
     opts.merge!(options)
 
@@ -28,6 +28,7 @@ module Kernel
 
       retries += 1
       retry_exception = exception
+      opts[:exception_cb].call(retry_exception)
       retry
     ensure
       opts[:ensure].call(retries)

data/lib/retryable/version.rb

@@ -2,7 +2,7 @@ module Retryable
   class Version
     MAJOR = 1 unless defined? Retryable::Version::MAJOR
     MINOR = 3 unless defined? Retryable::Version::MINOR
-    PATCH = 4 unless defined? Retryable::Version::PATCH
+    PATCH = 5 unless defined? Retryable::Version::PATCH
 
     class << self
 

data/spec/lib/retryable_spec.rb

@@ -107,4 +107,12 @@ describe 'Kernel.retryable' do
       retryable(:bad_option => 2) { raise "this is bad" }
     end.should raise_error ArgumentError, '[Retryable] Invalid options: bad_option'
   end
+
+  it 'accepts a callback to run after an exception is rescued' do
+    lambda do
+      retryable(:sleep => 0, :exception_cb => Proc.new {|e| @raised = e.to_s }) {|tries, ex| raise StandardError.new("this is fun!") if tries < 1 }
+    end.should_not raise_error
+
+    @raised.should == "this is fun!"
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: retryable
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.3.5
 platform: ruby
 authors:
 - Nikita Fedyashev
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-03 00:00:00.000000000 Z
+date: 2014-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler