try_again 1.0.0

data/README

@@ -0,0 +1,28 @@
+This method is usefull for when you want to attempt to get a resource on a network and it may fail.
+Or maybe you know that there's a possibility that the databases haven't sync yet and you want to try a few times till they do.
+
+This is one of the first few pieces of code I ever wrote in Ruby, it was intented to be help on random failure we had on automated testes where we were testing big applications that included many machines and databases whose sync was not always perfect (or our tests were too fast for the sync).
+
+It's really easy to use
+Just do 
+TryAgain.retry do
+    some code
+end
+
+By default it attempts your code 3 times with a 3 seconds sleep in between IF your code raises a StandardError.
+I SERIOUSLY recomend your code to raise some other error other than StandardError, or you may have some unexpected results when something that shouldn't fail does.
+
+You have a few options that you can pass:
+:attempts => (int) number of times to try run block till give up; defaults 3
+:sleep    => (int) seconds between each attempt; defaults 3
+:error    => (Constant) error to listen to; defaults StandardError
+:output   => (IO Object) It's kinda like a debug mode, but you can send an object like $stderr our $stdout or even a file so it's output doesn't get in the way of your normal output; defaults nil
+:kill    => (Boolean) If true after the last attempt it will raise your error back to you; defaults false
+
+You pass them as an hash like so:
+
+TryAgain.retry(:error => MyCustomErrorClass) do
+   raise MyCustomErrorClass if something
+end
+
+Finally, if :kill => false this method returns a Boolean whatever it passed or not.

data/lib/try_again.rb

@@ -0,0 +1,37 @@
+#@version 1
+#@author Arthur
+module TryAgain
+#@param options [Hash] (:sleep => number, :attempts => number, :error => Error, :kill => boolean)
+#@param block [Block] block of code to be attempted
+#@return [Boolean]
+    def self.retry( options={}, &block )
+        defaults = { :sleep => 3, :attempts => 3, :error => StandardError, :kill => false, :output => nil }
+        options  = defaults.merge options
+        out      = options[:output]
+        if out and !out.is_a? IO
+            raise InvalidOutput
+        end
+        attempts = 0
+        failed   = false
+
+        begin
+            yield
+        rescue options[:error]
+            attempts += 1
+            out.puts "#{ options[:error].to_s } for the #{attempts}# attempt" if out
+            if attempts < options[:attempts]
+                sleep options[:sleep]
+                retry
+            end
+            out.puts "#Giving up on #{ options[:error].to_s }, too many attempts" if out
+            raise options[:error] if options[:kill]
+            failed = true
+        end
+        if !failed and out
+            out.puts "#{ options[:error].to_s } took #{attempts + 1} attempts to pass"
+        end
+        return !failed
+    end
+
+    class InvalidOutput < StandardError; end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: try_again
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+  - Arthur Silva
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-09-03 00:00:00 Z
+dependencies: []
+
+description: "  This method is usefull for when you want to attempt to get a resource on a network and it may fail \n\n  Or maybe you know that there's a possibility that the databases haven't sync yet and you want to try a few times till they do\n"
+email: awls99@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+  - lib/try_again.rb
+  - README
+homepage: https://github.com/awls99/Try-Again
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A helping method to to retry a block a few times with a sleep in between
+test_files: []
+
+has_rdoc: