Class: IceCube::ValidatedRule

Inherits:
Rule
  • Object
show all
Includes:
IceCube::Validations::Count, IceCube::Validations::Day, IceCube::Validations::DayOfMonth, IceCube::Validations::DayOfWeek, IceCube::Validations::DayOfYear, IceCube::Validations::HourOfDay, IceCube::Validations::MinuteOfHour, IceCube::Validations::MonthOfYear, IceCube::Validations::ScheduleLock, IceCube::Validations::SecondOfMinute, IceCube::Validations::Until
Defined in:
lib/ice_cube/validated_rule.rb

Constant Summary collapse

VALIDATION_ORDER =

Validations ordered for efficiency in sequence of:

  • descending intervals

  • boundary limits

  • base values by cardinality (n = 60, 60, 31, 24, 12, 7)

  • locks by cardinality (n = 365, 60, 60, 31, 24, 12, 7)

  • interval multiplier

[
  :year, :month, :day, :wday, :hour, :min, :sec, :count, :until,
  :base_sec, :base_min, :base_day, :base_hour, :base_month, :base_wday,
  :day_of_year, :second_of_minute, :minute_of_hour, :day_of_month,
  :hour_of_day, :month_of_year, :day_of_week,
  :interval
]

Constants inherited from Rule

Rule::INTERVAL_TYPES

Instance Attribute Summary collapse

Attributes inherited from Rule

#uses

Instance Method Summary collapse

Methods included from IceCube::Validations::Until

#until, #until_time

Methods included from Deprecated

#deprecated, #deprecated_alias, schedule_options

Methods included from IceCube::Validations::Count

#count, #occurrence_count

Methods included from IceCube::Validations::DayOfYear

#day_of_year

Methods included from IceCube::Validations::MonthOfYear

#month_of_year

Methods included from IceCube::Validations::Day

#day

Methods included from IceCube::Validations::DayOfWeek

#day_of_week

Methods included from IceCube::Validations::DayOfMonth

#day_of_month

Methods included from IceCube::Validations::SecondOfMinute

#second_of_minute

Methods included from IceCube::Validations::MinuteOfHour

#minute_of_hour

Methods included from IceCube::Validations::HourOfDay

#hour_of_day

Methods included from IceCube::Validations::ScheduleLock

#schedule_lock

Methods inherited from Rule

#==, daily, from_hash, from_ical, from_yaml, #full_required?, #hash, hourly, minutely, monthly, #on?, secondly, #terminating?, #to_yaml, weekly, yearly

Constructor Details

#initialize(interval = 1) ⇒ ValidatedRule

Returns a new instance of ValidatedRule.



35
36
37
 
# File 'lib/ice_cube/validated_rule.rb', line 35

def initialize(interval = 1)
  @validations = Hash.new
end

Instance Attribute Details

#validations ⇒ Object (readonly)

Returns the value of attribute validations.



33
34
35
 
# File 'lib/ice_cube/validated_rule.rb', line 33

def validations
  @validations
end

Instance Method Details

#base_interval_type ⇒ Object 



54
55
56
 
# File 'lib/ice_cube/validated_rule.rb', line 54

def base_interval_type
  base_interval_validation.type
end

#base_interval_validation ⇒ Object 



46
47
48
 
# File 'lib/ice_cube/validated_rule.rb', line 46

def base_interval_validation
  @validations[:interval].first
end

#clobber_base_validations(*types) ⇒ Object

Remove the specified base validations



130
131
132
133
134
 
# File 'lib/ice_cube/validated_rule.rb', line 130

def clobber_base_validations(*types)
  types.each do |type|
    @validations.delete(:"base_#{type}")
  end
end

#dst_adjust? ⇒ Boolean

Returns:

  • (Boolean) 


81
82
83
 
# File 'lib/ice_cube/validated_rule.rb', line 81

def dst_adjust?
  @validations[:interval].any? &:dst_adjust?
end

#next_time(time, start_time, closing_time) ⇒ Object

Compute the next time after (or including) the specified time in respect to the given start time



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/ice_cube/validated_rule.rb', line 60

def next_time(time, start_time, closing_time)
  @time = time
  unless @start_time
    @start_time = realign(time, start_time)
    @time = @start_time if @time < @start_time
  end

  return nil unless find_acceptable_time_before(closing_time)

  @uses += 1 if @time
  @time
end

#other_interval_validations ⇒ Object 



50
51
52
 
# File 'lib/ice_cube/validated_rule.rb', line 50

def other_interval_validations
  Array(@validations[base_interval_validation.type])
end

#realign(opening_time, start_time) ⇒ Object 



73
74
75
 
# File 'lib/ice_cube/validated_rule.rb', line 73

def realign(opening_time, start_time)
  start_time
end

#replace_validations_for(key, arr) ⇒ Object

Fully replace validations



121
122
123
124
125
126
127
 
# File 'lib/ice_cube/validated_rule.rb', line 121

def replace_validations_for(key, arr)
  if arr.nil?
    @validations.delete(key)
  else
    @validations[key] = arr
  end
end

#reset ⇒ Object

Reset the uses on the rule to 0



40
41
42
43
44
 
# File 'lib/ice_cube/validated_rule.rb', line 40

def reset
  @time = nil
  @start_time = nil
  @uses = 0
end

#skipped_for_dst ⇒ Object 



77
78
79
 
# File 'lib/ice_cube/validated_rule.rb', line 77

def skipped_for_dst
  @uses -= 1 if @uses > 0
end

#to_hash ⇒ Object 



95
96
97
98
99
100
101
102
103
 
# File 'lib/ice_cube/validated_rule.rb', line 95

def to_hash
  builder = HashBuilder.new(self)
  @validations.each do |name, validations|
    validations.each do |validation|
      validation.build_hash(builder)
    end
  end
  builder.to_hash
end

#to_ical ⇒ Object 



105
106
107
108
109
110
111
112
113
 
# File 'lib/ice_cube/validated_rule.rb', line 105

def to_ical
  builder = IcalBuilder.new
  @validations.each do |name, validations|
    validations.each do |validation|
      validation.build_ical(builder)
    end
  end
  builder.to_s
end

#to_s ⇒ Object 



85
86
87
88
89
90
91
92
93
 
# File 'lib/ice_cube/validated_rule.rb', line 85

def to_s
  builder = StringBuilder.new
  @validations.each do |name, validations|
    validations.each do |validation|
      validation.build_s(builder)
    end
  end
  builder.to_s
end

#validations_for(key) ⇒ Object

Get the collection that contains validations of a certain type



116
117
118
 
# File 'lib/ice_cube/validated_rule.rb', line 116

def validations_for(key)
  @validations[key] ||= []
end