retriable 1.3.2 → 1.3.3

data/README.md

@@ -3,7 +3,7 @@ Retriable
 
 [![Build Status](https://secure.travis-ci.org/kamui/retriable.png)](http://travis-ci.org/kamui/retriable)
 
-Retriable is an simple DSL to retry code if an exception is raised.  This is especially useful when interacting external api/services or file system calls.
+Retriable is an simple DSL to retry a code block if an exception should be raised.  This is especially useful when interacting external api/services or file system calls.
 
 Installation
 ------------
@@ -28,7 +28,7 @@ gem 'retriable'
 Usage
 ---------------
 
-Code in a retriable block will be retried if an exception is raised. By default, Retriable will rescue any exception inherited from `Exception` and make 3 retry attempts before raising the last exception.
+Code in a retriable block will be retried if an exception is raised. By default, Retriable will rescue any exception inherited from `StandardError` (and `Timeout::Error`, which does not inherit from `StandardError` in ruby 1.8) and make 3 retry attempts before raising the last exception.
 
 ```ruby
 require 'retriable'
@@ -51,7 +51,7 @@ Here are the available options:
 
 `timeout` (default: 0) - Number of seconds to allow the code block to run before raising a Timeout::Error
 
-`on` (default: Exception) - Exception or array of exceptions to rescue for each attempt
+`on` (default: [StandardError, Timeout::Error]) - `StandardError` and `Timeout::Error` or array of exceptions to rescue for each attempt
 
 `on_retry` - (default: nil) - Proc to call after each attempt is rescued
 
@@ -106,7 +106,7 @@ begin
   retriable do
     # some code
   end
-rescue Exception => e
+rescue => e
   # run this if retriable ends up re-rasing the exception
 else
   # run this if retriable doesn't raise any exceptions
@@ -115,9 +115,9 @@ ensure
 end
 ```
 
-Non Kernel included version
----------------------------
-By default, requiring 'retriable' will include the #retriable method into th Kernel so that you can use it anywhere. If you don't want this behaviour, you can load a non-kernel included version:
+Non Kernel version
+------------------
+By default, `require 'retriable'` will include the `#retriable` method into the `Kernel` so that you can use it everywhere. If you don't want this behaviour, you can load a non-kernel version:
 
 ```ruby
 gem 'retriable', require => 'retriable/no_kernel'
@@ -129,7 +129,7 @@ Or in your ruby script:
 require 'retriable/no_kernel'
 ```
 
-In this case, you'll just execute a retriable block from the Retriable module:
+In this case, you'll just execute a retriable block from the `Retriable` module:
 
 ```ruby
 Retriable.retriable do

data/lib/retriable/retriable.rb

@@ -34,8 +34,8 @@ module Retriable
         @tries -= 1
         if @tries > 0
           count += 1
-          sleep @interval if @interval > 0
           @on_retry.call(exception, count) if @on_retry
+          sleep @interval if @interval > 0
           retry
         else
           raise

data/lib/retriable/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module Retriable
-  VERSION = '1.3.2'
+  VERSION = '1.3.3'
 end

data/retriable.gemspec

@@ -10,8 +10,8 @@ Gem::Specification.new do |s|
   s.authors     = ["Jack Chu"]
   s.email       = ["jack@jackchu.com"]
   s.homepage    = %q{http://github.com/kamui/retriable}
-  s.summary     = %q{Retriable is an simple DSL to retry code if an exception is raised.}
-  s.description = %q{Retriable is an simple DSL to retry code if an exception is raised. This is especially useful when interacting external api/services or file system calls.}
+  s.summary     = %q{Retriable is an simple DSL to retry a code block if an exception should be raised.}
+  s.description = %q{Retriable is an simple DSL to retry a code block if an exception should be raised. This is especially useful when interacting external api/services or file system calls.}
 
   s.rubyforge_project = "retriable"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: retriable
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.3.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-07 00:00:00.000000000 Z
+date: 2012-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70283922934020 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70283922934020
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70283922933200 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,9 +37,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70283922933200
-description: Retriable is an simple DSL to retry code if an exception is raised. This
-  is especially useful when interacting external api/services or file system calls.
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Retriable is an simple DSL to retry a code block if an exception should
+  be raised. This is especially useful when interacting external api/services or file
+  system calls.
 email:
 - jack@jackchu.com
 executables: []
@@ -67,17 +78,24 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 1988275936415246250
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 1988275936415246250
 requirements: []
 rubyforge_project: retriable
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Retriable is an simple DSL to retry code if an exception is raised.
+summary: Retriable is an simple DSL to retry a code block if an exception should be
+  raised.
 test_files:
 - test/retriable_test.rb