zeevex_reliability 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in zeevex_reliability.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1,32 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :spec do
+  desc "Run on three Rubies"
+  task :platforms do
+    current = %x{rvm-prompt v}
+    
+    fail = false
+    %w{1.8.7 1.9.2}.each do |version|
+      puts "Switching to #{version}"
+      Bundler.with_clean_env do
+        system %{bash -c 'source ~/.rvm/scripts/rvm && rvm #{version} && bundle exec rake spec'}
+      end
+      if $?.exitstatus != 0
+        fail = true
+        break
+      end
+    end
+
+    system %{rvm #{current}}
+
+    exit (fail ? 1 : 0)
+  end
+end
+
+task :default => 'spec'

data/lib/zeevex_reliability/optimistic_lock_retryable.rb

@@ -0,0 +1,48 @@
+module ZeevexReliability
+  module OptimisticLockRetryable
+    def self.included(base)
+      base.class_eval do
+        include InstanceMethods
+      end
+    end
+
+    module InstanceMethods
+      # Options:
+      # * :tries - Number of retries to perform. Defaults to 3.
+      #
+      # If the final attempts also receives an exception, that exception
+      # will be raised.
+      #
+      # Example
+      # =======
+      #   model.with_optimistic_retry(:tries => 5) do
+      #     # your model frobbing code here
+      #     model.save!
+      #   end
+      #
+      def with_optimistic_retry(options = {}, &block)
+        opts = { :tries => 3 }.merge(options)
+        retries = opts[:tries]
+
+        # a retry may reload the object, so log a message that this
+        # may be used incorrectly
+        if changed?
+          logger.warn "WARNING: with_optimistic_retry called on changed object; if the save fails, changes will be lost!"
+        end
+
+        begin
+          return yield
+        rescue ActiveRecord::StaleObjectError
+          if (retries -= 1) > 0
+            self.reload
+            retry
+          else
+            raise
+          end
+        end
+      end
+    end
+    
+  end
+end
+

data/lib/zeevex_reliability/retryable.rb

@@ -0,0 +1,35 @@
+module ZeevexReliability
+  module Retryable
+    # Options:
+    # * :tries - Number of retries to perform. Defaults to 3.
+    # * :on - The Exception on which a retry will be performed.
+    #         Defaults to StandardError
+    #
+    # If the final attempts also receives an exception, that exception
+    # will be raised.
+    #
+    # Example
+    # =======
+    #   retryable(:tries => 1, :on => OpenURI::HTTPError) do
+    #     # your code here
+    #   end
+    #
+    def self.retry(options = {}, &block)
+      opts = { :tries => 3, :on => StandardError }.merge(options)
+
+      retry_exception, retries = opts[:on], opts[:tries]
+
+      begin
+        return yield
+      rescue retry_exception
+        if (retries -= 1) > 0
+          retry
+        else
+          raise
+        end
+      end
+    end
+  end
+  
+end
+

data/lib/zeevex_reliability/version.rb

@@ -0,0 +1,3 @@
+module ZeevexReliability
+  VERSION = "0.1.0"
+end

data/lib/zeevex_reliability.rb

@@ -0,0 +1,7 @@
+
+module ZeevexReliability
+  
+end
+
+require 'zeevex_reliability/retryable'
+require 'zeevex_reliability/optimistic_lock_retryable'

data/zeevex_reliability.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "zeevex_reliability/version"
+
+Gem::Specification.new do |s|
+  s.name        = "zeevex_reliability"
+  s.version     = ZeevexReliability::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Robert Sanders"]
+  s.email       = ["robert@zeevex.com"]
+  s.homepage    = ""
+  s.summary     = %q{Utility functions to automate retry loops}
+  s.description = %q{Includes a general and an ActiveRecord StaleObject-focused retry loop}
+
+  s.rubyforge_project = "zeevex_reliability"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_development_dependency 'rspec', '~> 2.9.0'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'activerecord', '~> 2.3.0'
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: zeevex_reliability
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Robert Sanders
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-05-07 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 9
+        - 0
+        version: 2.9.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :development
+  version_requirements: *id003
+description: Includes a general and an ActiveRecord StaleObject-focused retry loop
+email: 
+- robert@zeevex.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- lib/zeevex_reliability.rb
+- lib/zeevex_reliability/optimistic_lock_retryable.rb
+- lib/zeevex_reliability/retryable.rb
+- lib/zeevex_reliability/version.rb
+- zeevex_reliability.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: zeevex_reliability
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Utility functions to automate retry loops
+test_files: []
+