hiccup 0.5.14 → 0.5.15

data/lib/hiccup/errors.rb

@@ -0,0 +1,4 @@
+module Hiccup
+  class UnboundedEnumerationError < RuntimeError
+  end
+end

data/lib/hiccup/humanizable.rb

@@ -5,9 +5,9 @@ require "hiccup/core_ext/fixnum"
 module Hiccup
   module Humanizable
     include Convenience
-    
-    
-    
+
+
+
     def humanize(format: "%Y-%m-%d")
       case kind
       when :never;      start_date.strftime(format)
@@ -17,13 +17,13 @@ module Hiccup
       else;             "Invalid"
       end
     end
-    
-    
-    
+
+
+
   private
-    
-    
-    
+
+
+
     def weekly_humanize
       weekdays_sentece = weekly_pattern.map(&:humanize).to_sentence
       if skip == 1 || weekly_pattern.length == 1
@@ -32,18 +32,18 @@ module Hiccup
         sentence(weekdays_sentece, "of every", ordinal, "week")
       end
     end
-    
+
     def monthly_humanize
       monthly_occurrences = monthly_pattern.map(&method(:monthly_occurrence_to_s)).to_sentence
       sentence("The", monthly_occurrences, "of every", ordinal, "month")
     end
-    
+
     def yearly_humanize
       sentence("Every", ordinal, "year on", self.start_date.strftime('%B'), self.start_date.strftime('%e').strip)
     end
-    
-    
-    
+
+
+
     def monthly_occurrence_to_s(monthly_occurrence)
       if monthly_occurrence.is_a?(Array)
         _skip, weekday = monthly_occurrence
@@ -53,16 +53,16 @@ module Hiccup
         monthly_occurrence < 0 ? "last day" : monthly_occurrence.ordinalize
       end
     end
-    
+
     def ordinal
       skip && skip.human_ordinalize(1 => nil, 2 => "other")
     end
-    
+
     def sentence(*array)
       array.compact.join(" ")
     end
-    
-    
-    
+
+
+
   end
 end

data/lib/hiccup/inferable.rb

@@ -11,43 +11,43 @@ require 'hiccup/inferable/score'
 module Hiccup
   module Inferable
     extend ActiveSupport::Concern
-    
+
     module ClassMethods
-      
+
       def infer(dates, options={})
         allow_null_schedules = options.fetch(:allow_null_schedules, false)
         verbosity = options.fetch(:verbosity, (options[:verbose] ? 1 : 0)) # 0, 1, or 2
-        
+
         dates = extract_array_of_dates!(dates)
         enumerator = DatesEnumerator.new(dates)
         guesser = options.fetch :guesser, Guesser.new(self, options.merge(verbose: verbosity >= 2))
         scorer = options.fetch(:scorer, Scorer.new(options.merge(verbose: verbosity >= 2)))
-        
+
         dates = []
         schedules = []
         confidences = []
         high_confidence_threshold = 0.6
         min_confidence_threshold  = 0.35
-        
+
         last_confident_schedule = nil
         iterations_since_last_confident_schedule = 0
-        
+
         until enumerator.done?
           date = enumerator.next
           dates << date
           guesses = guesser.generate_guesses(dates)
-          
+
           # ! can guess and confidence be nil here??
           guess, confidence = scorer.pick_best_guess(guesses, dates)
-          
+
           confidence = confidence.to_f
           confidences << confidence
           predicted = guess.predicts?(date)
-          
+
           # if the last two confidences are both below a certain
           # threshhold and both declining, back up to where we
           # started to go wrong and start a new schedule.
-          
+
           confident = !(confidences.length >= 3 && (
                         (confidences[-1] < high_confidence_threshold &&
                          confidences[-2] < high_confidence_threshold &&
@@ -55,18 +55,18 @@ module Hiccup
                          confidences[-2] < confidences[-3]) ||
                         (confidences[-1] < min_confidence_threshold &&
                          confidences[-2] < min_confidence_threshold)))
-          
+
           if predicted && confidence >= min_confidence_threshold
             iterations_since_last_confident_schedule = 0
             last_confident_schedule = guess
           else
             iterations_since_last_confident_schedule += 1
           end
-          
+
           rewind_by = iterations_since_last_confident_schedule == dates.count ? iterations_since_last_confident_schedule - 1 : iterations_since_last_confident_schedule
-          
-          
-          
+
+
+
           if verbosity >= 1
             output = "  #{enumerator.index.to_s.rjust(3)} #{date}"
             output << " #{"[#{dates.count}]".rjust(5)}  =>  "
@@ -75,11 +75,11 @@ module Hiccup
             output << "  :( move back #{rewind_by}" unless confident
             puts output
           end
-          
-          
-          
+
+
+
           unless confident
-            
+
             if last_confident_schedule
               schedules << last_confident_schedule
             elsif allow_null_schedules
@@ -87,7 +87,7 @@ module Hiccup
                 schedules << self.new(:kind => :never, :start_date => date)
               end
             end
-            
+
             enumerator.rewind_by(rewind_by)
             dates = []
             confidences = []
@@ -95,7 +95,7 @@ module Hiccup
             last_confident_schedule = nil
           end
         end
-        
+
         if last_confident_schedule
           schedules << last_confident_schedule
         elsif allow_null_schedules
@@ -103,28 +103,28 @@ module Hiccup
             schedules << self.new(:kind => :never, :start_date => date)
           end
         end
-        
+
         schedules
       end
-      
-      
-      
+
+
+
       def extract_array_of_dates!(dates)
         raise_invalid_dates_error! unless dates.respond_to?(:each)
         dates.map { |date| assert_date!(date) }.sort
       end
-      
+
       def assert_date!(date)
         return date if date.is_a?(Date)
         date.to_date rescue raise_invalid_dates_error!
       end
-      
+
       def raise_invalid_dates_error!
         raise ArgumentError.new("Inferable.infer expects to receive a collection of dates")
       end
-      
-      
-      
+
+
+
     end
   end
 end

data/lib/hiccup/inferable/dates_enumerator.rb

@@ -1,30 +1,30 @@
 module Hiccup
   module Inferable
     class DatesEnumerator
-      
+
       def initialize(dates)
         @dates = dates
         @last_index = @dates.length - 1
         @index = -1
       end
-      
+
       attr_reader :index
-      
+
       def done?
         @index == @last_index
       end
-      
+
       def next
         @index += 1
         raise OutOfRangeException if @index > @last_index
         @dates[@index]
       end
-      
+
       def rewind_by(n)
         @index -= n
         @index = -1 if @index < -1
       end
-      
+
     end
   end
 end

data/lib/hiccup/inferable/guesser.rb

@@ -3,22 +3,22 @@ require 'hiccup/inferable/scorer'
 module Hiccup
   module Inferable
     class Guesser
-      
+
       def initialize(klass, options={})
         @klass = klass
         @verbose = options.fetch(:verbose, false)
         @allow_skips = options.fetch(:allow_skips, true)
         @max_complexity = options.fetch(:max_complexity, 3)
       end
-      
+
       attr_reader :max_complexity
-      
+
       def allow_skips?
         @allow_skips
       end
-      
-      
-      
+
+
+
       def generate_guesses(dates)
         @start_date = dates.first
         @end_date = dates.last
@@ -28,7 +28,7 @@ module Hiccup
           guesses.concat generate_weekly_guesses(dates)
         end
       end
-      
+
       def generate_yearly_guesses(dates)
         histogram_of_patterns = dates.to_histogram do |date|
           [date.month, date.day]
@@ -37,7 +37,7 @@ module Hiccup
         highest_popularity = patterns_by_popularity.keys.max # => 5
         most_popular = patterns_by_popularity[highest_popularity].first # => a
         start_date = Date.new(@start_date.year, *most_popular)
-        
+
         [].tap do |guesses|
           skip_range.each do |skip|
             guesses << @klass.new.tap do |schedule|
@@ -49,16 +49,16 @@ module Hiccup
           end
         end
       end
-      
+
       def generate_monthly_guesses(dates)
         histogram_of_patterns = dates.to_histogram do |date|
           [date.get_nth_wday_of_month, Date::DAYNAMES[date.wday]]
         end
         patterns_by_popularity = histogram_of_patterns.flip
-        
+
         histogram_of_days = dates.to_histogram(&:day)
         days_by_popularity = histogram_of_days.flip
-        
+
         if @verbose
           puts "",
                "  monthly analysis:",
@@ -68,7 +68,7 @@ module Hiccup
                "    histogram (day): #{histogram_of_days.inspect}",
                "    by_popularity (day): #{days_by_popularity.inspect}"
         end
-        
+
         [].tap do |guesses|
           skip_range.each do |skip|
             enumerate_by_popularity(days_by_popularity) do |days|
@@ -81,7 +81,7 @@ module Hiccup
                 schedule.monthly_pattern = days
               end
             end
-            
+
             enumerate_by_popularity(patterns_by_popularity) do |patterns|
               next if patterns.length > max_complexity
               guesses << @klass.new.tap do |schedule|
@@ -95,14 +95,14 @@ module Hiccup
           end
         end
       end
-      
+
       def generate_weekly_guesses(dates)
         [].tap do |guesses|
           histogram_of_wdays = dates.to_histogram do |date|
             Date::DAYNAMES[date.wday]
           end
           wdays_by_popularity = histogram_of_wdays.flip
-          
+
           if @verbose
             puts "",
                  "  weekly analysis:",
@@ -110,7 +110,7 @@ module Hiccup
                  "    histogram: #{histogram_of_wdays.inspect}",
                  "    by_popularity: #{wdays_by_popularity.inspect}"
           end
-          
+
           skip_range.each do |skip|
             enumerate_by_popularity(wdays_by_popularity) do |wdays|
               next if wdays.length > max_complexity
@@ -125,14 +125,14 @@ module Hiccup
           end
         end
       end
-      
+
       def skip_range
         return 1..1 unless allow_skips?
         1...5
       end
-      
-      
-      
+
+
+
       # Expects a hash of values grouped by popularity
       # Yields the most popular values first, and then
       # increasingly less popular values
@@ -143,7 +143,7 @@ module Hiccup
           yield values_by_popularity.values_at(*at_popularities).flatten(1)
         end
       end
-      
+
     end
   end
 end

data/lib/hiccup/inferable/score.rb

@@ -1,15 +1,15 @@
 module Hiccup
   module Inferable
-    
+
     class Score < Struct.new(:prediction_rate, :brick_rate, :complexity_rate)
-      
+
       # as brick rate rises, our confidence in this guess drops
       def brick_penalty
         brick_penalty = brick_rate * 0.33
         brick_penalty = 1 if brick_penalty > 1
         brick_penalty
       end
-      
+
       # as the complexity rises, our confidence in this guess drops
       # this hash table is a stand-in for a proper formala
       #
@@ -18,7 +18,7 @@ module Hiccup
       def complexity_penalty
         complexity_rate
       end
-      
+
       # our confidence is weakened by bricks and complexity
       def confidence
         confidence = 1.0
@@ -26,13 +26,13 @@ module Hiccup
         confidence *= (1 - complexity_penalty)
         confidence
       end
-      
+
       # a number between 0 and 1
       def to_f
         prediction_rate * confidence
       end
-      
+
     end
-    
+
   end
 end