wait 0.4 → 0.4.1

data/lib/counters/base.rb

@@ -0,0 +1,43 @@
+class Wait
+  class BaseCounter
+    attr_reader :attempt
+
+    def initialize(logger, total)
+      @logger = logger
+      # Attempt to prevent causing an infinite loop by being very strict about
+      # the value passed.
+      unless total.is_a?(Fixnum) and total > 0
+        raise(ArgumentError, "invalid number of attempts: #{total.inspect}")
+      end
+
+      @total = total
+      reset
+    end
+
+    # Called before all attempts to reset the counter.
+    def reset
+      @attempt = 0
+    end
+
+    # Called before each attempt to increment the counter.
+    def increment
+      @attempt += 1
+      log
+    end
+
+    # Returns +true+ if this is the last attempt.
+    def last_attempt?
+      @attempt == @total
+    end
+
+    # Logs the current attempt count.
+    def log
+      @logger.debug "[Counter] attempt #{self}"
+    end
+
+    # Returns a string representation of the current count.
+    def to_s
+      [@attempt, @total].join("/")
+    end
+  end # BaseCounter
+end # Wait

data/lib/delayers/base.rb

@@ -0,0 +1,24 @@
+class Wait
+  class BaseDelayer
+    def initialize(logger, initial_delay)
+      @logger = logger
+      @delay  = initial_delay
+    end
+
+    # Called before a reattempt to sleep a certain about of time.
+    def sleep
+      log_delay
+      Kernel.sleep(@delay)
+    end
+
+    # Logs how long the delay is.
+    def log_delay
+      @logger.debug "[Delayer] delaying for #{self}"
+    end
+
+    # Returns a string representation of the delay.
+    def to_s
+      "#{@delay}s"
+    end
+  end # BaseDelayer
+end # Wait

data/lib/delayers/exponential.rb

@@ -0,0 +1,12 @@
+class Wait
+  class ExponentialDelayer < RegularDelayer
+    def sleep
+      super
+      increment
+    end
+
+    def increment
+      @delay *= 2
+    end
+  end # ExponentialDelayer
+end # Wait

data/lib/delayers/regular.rb

@@ -0,0 +1,3 @@
+class Wait
+  class RegularDelayer < BaseDelayer; end
+end # Wait

data/lib/initialize.rb

@@ -0,0 +1,16 @@
+require "timeout"
+require "logger"
+require "forwardable"
+
+require File.expand_path("../loggers/base",         __FILE__)
+require File.expand_path("../loggers/debug",        __FILE__)
+require File.expand_path("../counters/base",        __FILE__)
+require File.expand_path("../delayers/base",        __FILE__)
+require File.expand_path("../delayers/regular",     __FILE__)
+require File.expand_path("../delayers/exponential", __FILE__)
+require File.expand_path("../testers/base",         __FILE__)
+require File.expand_path("../testers/passive",      __FILE__)
+require File.expand_path("../testers/truthy",       __FILE__)
+require File.expand_path("../rescuers/base",        __FILE__)
+require File.expand_path("../raisers/base",         __FILE__)
+require File.expand_path("../raisers/passive",      __FILE__)

data/lib/loggers/base.rb

@@ -0,0 +1,32 @@
+class Wait
+  class BaseLogger
+    extend Forwardable
+
+    attr_reader :logger
+    def_delegators :logger, :fatal,
+                           :error,
+                           :warn,
+                           :info,
+                           :debug
+
+    def initialize
+      @logger           = ::Logger.new(STDOUT)
+      @logger.level     = level
+      @logger.formatter = formatter
+    end
+
+    def level
+      ::Logger::WARN
+    end
+
+    def formatter
+      proc do |severity, datetime, program_name, message|
+        [severity.ljust(5), message].join(" ") + "\n"
+      end
+    end
+
+    def backtrace(backtrace)
+      backtrace.map { |line| (" " * 25) + line }.join("\n")
+    end
+  end # Logger
+end # Wait

data/lib/loggers/debug.rb

@@ -0,0 +1,7 @@
+class Wait
+  class DebugLogger < BaseLogger
+    def level
+      ::Logger::DEBUG
+    end
+  end # Logger
+end # Wait

data/lib/raisers/base.rb

@@ -0,0 +1,18 @@
+class Wait
+  class BaseRaiser
+    def initialize(logger, exception)
+      @logger    = logger
+      @exception = exception
+      log
+    end
+
+    # Returns +true+ if an exception ought to be raised.
+    def raise?
+      false
+    end
+
+    def log
+      @logger.debug "[Raiser] raise? #{@exception.class.name}: #{raise?}"
+    end
+  end # BaseRaiser
+end # Wait

data/lib/raisers/passive.rb

@@ -0,0 +1,3 @@
+class Wait
+  class PassiveRaiser < BaseRaiser; end
+end # Wait

data/lib/rescuers/base.rb

@@ -0,0 +1,15 @@
+class Wait
+  class BaseRescuer
+    attr_reader :exceptions
+
+    def initialize(logger, *exceptions)
+      @logger     = logger
+      @exceptions = Array(exceptions).flatten
+    end
+
+    # Logs an exception.
+    def log(exception)
+      @logger.debug "[Rescuer] rescued: #{exception.class.name}: #{exception.message}\n#{@logger.backtrace(exception.backtrace)}"
+    end
+  end # BaseRescuer
+end # Wait

data/lib/testers/base.rb

@@ -0,0 +1,18 @@
+class Wait
+  class BaseTester
+    def initialize(logger, result)
+      @logger = logger
+      @result = result
+      log
+    end
+
+    # Returns +true+ if a result if valid.
+    def valid?
+      true
+    end
+
+    def log
+      @logger.debug "[Tester] result: #{@result.inspect}"
+    end
+  end # BaseTester
+end # Wait

data/lib/testers/passive.rb

@@ -0,0 +1,3 @@
+class Wait
+  class PassiveTester < BaseTester; end
+end # Wait

data/lib/testers/truthy.rb

@@ -0,0 +1,7 @@
+class Wait
+  class TruthyTester < BaseTester
+    def valid?
+      not (@result.nil? or @result == false)
+    end
+  end # TruthyTester
+end # Wait

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wait
 version: !ruby/object:Gem::Version
-  version: '0.4'
+  version: 0.4.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-08 00:00:00.000000000 Z
+date: 2013-01-09 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: todd@paperlesspost.com
@@ -17,6 +17,19 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/counters/base.rb
+- lib/delayers/base.rb
+- lib/delayers/exponential.rb
+- lib/delayers/regular.rb
+- lib/initialize.rb
+- lib/loggers/base.rb
+- lib/loggers/debug.rb
+- lib/raisers/base.rb
+- lib/raisers/passive.rb
+- lib/rescuers/base.rb
+- lib/testers/base.rb
+- lib/testers/passive.rb
+- lib/testers/truthy.rb
 - lib/wait.rb
 homepage: http://github.com/paperlesspost/wait
 licenses: []