Class: Split::Experiment
- Inherits:
-
Object
- Object
- Split::Experiment
- Defined in:
- lib/split/experiment.rb
Instance Attribute Summary collapse
-
#name ⇒ Object
Returns the value of attribute name.
-
#winner ⇒ Object
Returns the value of attribute winner.
Class Method Summary collapse
- .all ⇒ Object
- .find(name) ⇒ Object
- .find_or_create(key, *alternatives) ⇒ Object
- .initialize_alternatives(alternatives, name) ⇒ Object
- .load_alternatives_for(name) ⇒ Object
Instance Method Summary collapse
- #alternative_names ⇒ Object
- #alternatives ⇒ Object
- #control ⇒ Object
- #delete ⇒ Object
- #increment_version ⇒ Object
-
#initialize(name, *alternative_names) ⇒ Experiment
constructor
A new instance of Experiment.
- #key ⇒ Object
- #new_record? ⇒ Boolean
- #next_alternative ⇒ Object
- #random_alternative ⇒ Object
- #reset ⇒ Object
- #reset_winner ⇒ Object
- #save ⇒ Object
- #start_time ⇒ Object
- #version ⇒ Object
Constructor Details
#initialize(name, *alternative_names) ⇒ Experiment
Returns a new instance of Experiment.
6 7 8 9 10 11 |
# File 'lib/split/experiment.rb', line 6 def initialize(name, *alternative_names) @name = name.to_s @alternatives = alternative_names.map do |alternative| Split::Alternative.new(alternative, name) end end |
Instance Attribute Details
#name ⇒ Object
Returns the value of attribute name.
3 4 5 |
# File 'lib/split/experiment.rb', line 3 def name @name end |
#winner ⇒ Object
Returns the value of attribute winner.
4 5 6 |
# File 'lib/split/experiment.rb', line 4 def winner @winner end |
Class Method Details
.all ⇒ Object
116 117 118 |
# File 'lib/split/experiment.rb', line 116 def self.all Array(Split.redis.smembers(:experiments)).map {|e| find(e)} end |
.find(name) ⇒ Object
120 121 122 123 124 |
# File 'lib/split/experiment.rb', line 120 def self.find(name) if Split.redis.exists(name) self.new(name, *load_alternatives_for(name)) end end |
.find_or_create(key, *alternatives) ⇒ Object
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 |
# File 'lib/split/experiment.rb', line 126 def self.find_or_create(key, *alternatives) name = key.to_s.split(':')[0] if alternatives.length == 1 if alternatives[0].is_a? Hash alternatives = alternatives[0].map{|k,v| {k => v} } else raise InvalidArgument, 'You must declare at least 2 alternatives' end end alts = initialize_alternatives(alternatives, name) if Split.redis.exists(name) if load_alternatives_for(name) == alts.map(&:name) experiment = self.new(name, *alternatives) else exp = self.new(name, *load_alternatives_for(name)) exp.reset exp.alternatives.each(&:delete) experiment = self.new(name, *alternatives) experiment.save end else experiment = self.new(name, *alternatives) experiment.save end return experiment end |
.initialize_alternatives(alternatives, name) ⇒ Object
157 158 159 160 161 162 163 164 165 166 |
# File 'lib/split/experiment.rb', line 157 def self.initialize_alternatives(alternatives, name) unless alternatives.all? { |a| Split::Alternative.valid?(a) } raise InvalidArgument, 'Alternatives must be strings' end alternatives.map do |alternative| Split::Alternative.new(alternative, name) end end |
.load_alternatives_for(name) ⇒ Object
104 105 106 107 108 109 110 111 112 113 114 |
# File 'lib/split/experiment.rb', line 104 def self.load_alternatives_for(name) case Split.redis.type(name) when 'set' # convert legacy sets to lists alts = Split.redis.smembers(name) Split.redis.del(name) alts.reverse.each {|a| Split.redis.lpush(name, a) } Split.redis.lrange(name, 0, -1) else Split.redis.lrange(name, 0, -1) end end |
Instance Method Details
#alternative_names ⇒ Object
42 43 44 |
# File 'lib/split/experiment.rb', line 42 def alternative_names @alternatives.map(&:name) end |
#alternatives ⇒ Object
38 39 40 |
# File 'lib/split/experiment.rb', line 38 def alternatives @alternatives.dup end |
#control ⇒ Object
21 22 23 |
# File 'lib/split/experiment.rb', line 21 def control alternatives.first end |
#delete ⇒ Object
84 85 86 87 88 89 90 |
# File 'lib/split/experiment.rb', line 84 def delete alternatives.each(&:delete) reset_winner Split.redis.srem(:experiments, name) Split.redis.del(name) increment_version end |
#increment_version ⇒ Object
66 67 68 |
# File 'lib/split/experiment.rb', line 66 def increment_version @version = Split.redis.incr("#{name}:version") end |
#key ⇒ Object
70 71 72 73 74 75 76 |
# File 'lib/split/experiment.rb', line 70 def key if version.to_i > 0 "#{name}:#{version}" else name end end |
#new_record? ⇒ Boolean
92 93 94 |
# File 'lib/split/experiment.rb', line 92 def new_record? !Split.redis.exists(name) end |
#next_alternative ⇒ Object
46 47 48 |
# File 'lib/split/experiment.rb', line 46 def next_alternative winner || random_alternative end |
#random_alternative ⇒ Object
50 51 52 53 54 55 56 57 58 59 60 |
# File 'lib/split/experiment.rb', line 50 def random_alternative weights = alternatives.map(&:weight) total = weights.inject(:+) point = rand * total alternatives.zip(weights).each do |n,w| return n if w >= point point -= w end end |
#reset ⇒ Object
78 79 80 81 82 |
# File 'lib/split/experiment.rb', line 78 def reset alternatives.each(&:reset) reset_winner increment_version end |
#reset_winner ⇒ Object
25 26 27 |
# File 'lib/split/experiment.rb', line 25 def reset_winner Split.redis.hdel(:experiment_winner, name) end |
#save ⇒ Object
96 97 98 99 100 101 102 |
# File 'lib/split/experiment.rb', line 96 def save if new_record? Split.redis.sadd(:experiments, name) Split.redis.hset(:experiment_start_times, @name, Time.now) @alternatives.reverse.each {|a| Split.redis.lpush(name, a.name) } end end |