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
- #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
111 112 113 |
# File 'lib/split/experiment.rb', line 111 def self.all Array(Split.redis.smembers(:experiments)).map {|e| find(e)} end |
.find(name) ⇒ Object
115 116 117 118 119 |
# File 'lib/split/experiment.rb', line 115 def self.find(name) if Split.redis.exists(name) self.new(name, *load_alternatives_for(name)) end end |
.find_or_create(key, *alternatives) ⇒ Object
121 122 123 124 125 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 |
# File 'lib/split/experiment.rb', line 121 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, *load_alternatives_for(name)) 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
152 153 154 155 156 157 158 159 160 161 |
# File 'lib/split/experiment.rb', line 152 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
99 100 101 102 103 104 105 106 107 108 109 |
# File 'lib/split/experiment.rb', line 99 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
38 39 40 |
# File 'lib/split/experiment.rb', line 38 def alternative_names @alternatives.map(&:name) end |
#alternatives ⇒ Object
34 35 36 |
# File 'lib/split/experiment.rb', line 34 def alternatives @alternatives.dup end |
#control ⇒ Object
21 22 23 |
# File 'lib/split/experiment.rb', line 21 def control alternatives.first end |
#delete ⇒ Object
80 81 82 83 84 85 86 |
# File 'lib/split/experiment.rb', line 80 def delete alternatives.each(&:delete) reset_winner Split.redis.srem(:experiments, name) Split.redis.del(name) increment_version end |
#increment_version ⇒ Object
62 63 64 |
# File 'lib/split/experiment.rb', line 62 def increment_version @version = Split.redis.incr("#{name}:version") end |
#key ⇒ Object
66 67 68 69 70 71 72 |
# File 'lib/split/experiment.rb', line 66 def key if version.to_i > 0 "#{name}:#{version}" else name end end |
#new_record? ⇒ Boolean
88 89 90 |
# File 'lib/split/experiment.rb', line 88 def new_record? !Split.redis.exists(name) end |
#next_alternative ⇒ Object
42 43 44 |
# File 'lib/split/experiment.rb', line 42 def next_alternative winner || random_alternative end |
#random_alternative ⇒ Object
46 47 48 49 50 51 52 53 54 55 56 |
# File 'lib/split/experiment.rb', line 46 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
74 75 76 77 78 |
# File 'lib/split/experiment.rb', line 74 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 |