class Split::ExperimentCatalog

Public Class Methods

all() click to toggle source

Return all experiments

# File lib/split/experiment_catalog.rb, line 5
def self.all
  # Call compact to prevent nil experiments from being returned -- seems to happen during gem upgrades
  Split.redis.smembers(:experiments).map {|e| find(e)}.compact
end
all_active_first() click to toggle source

Return experiments without a winner (considered “active”) first

# File lib/split/experiment_catalog.rb, line 11
def self.all_active_first
  all.partition{|e| not e.winner}.map{|es| es.sort_by(&:name)}.flatten
end
find(name) click to toggle source
# File lib/split/experiment_catalog.rb, line 15
def self.find(name)
  return unless Split.redis.exists(name)
  Experiment.new(name).tap { |exp| exp.load_from_redis }
end
find_or_create(metric_descriptor, control = nil, *alternatives) click to toggle source
# File lib/split/experiment_catalog.rb, line 33
def self.find_or_create(metric_descriptor, control = nil, *alternatives)
  experiment = find_or_initialize(metric_descriptor, control, *alternatives)
  experiment.save
end
find_or_initialize(metric_descriptor, control = nil, *alternatives) click to toggle source
# File lib/split/experiment_catalog.rb, line 20
def self.find_or_initialize(metric_descriptor, control = nil, *alternatives)
  # Check if array is passed to ab_test
  # e.g. ab_test('name', ['Alt 1', 'Alt 2', 'Alt 3'])
  if control.is_a? Array and alternatives.length.zero?
    control, alternatives = control.first, control[1..-1]
  end

  experiment_name_with_version, goals = normalize_experiment(metric_descriptor)
  experiment_name = experiment_name_with_version.to_s.split(':')[0]
  Split::Experiment.new(experiment_name,
      :alternatives => [control].compact + alternatives, :goals => goals)
end

Private Class Methods

normalize_experiment(metric_descriptor) click to toggle source
# File lib/split/experiment_catalog.rb, line 38
def self.normalize_experiment(metric_descriptor)
  if Hash === metric_descriptor
    experiment_name = metric_descriptor.keys.first
    goals = Array(metric_descriptor.values.first)
  else
    experiment_name = metric_descriptor
    goals = []
  end
  return experiment_name, goals
end