a_b_split 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 68847be6d549eec7d1c38762adf5e8f364b9c6cd
-  data.tar.gz: 6f2a635a1b583d16628cc869f1fd5821de88dfb6
+  metadata.gz: 8d6337e9baf884dc54218a8b6ad030b7256ec30c
+  data.tar.gz: e4af93072dfacd1a96f4d73a0182bc0c8a7b0104
 SHA512:
-  metadata.gz: d696a619d46b093f519db62503fd7ba00db839f13aa4940d78d1bb0cfb51d927494d642aa991a15e24cb8e0104d225c863f2dc003ca8c490375e95307d5d56da
-  data.tar.gz: 7dff2394c950bdf30ee68999214c7d2a3c5db7073de1ae6c384504362568b3f20dfaed63821d0a7877021e928592263715e52b695f7ffd9277b2b658884353d8
+  metadata.gz: d9e09bbc215026262b7bc48919e99ad3092653967870daedeef421b49453cb4cd0223777dba430d0d4f83243a41711fe3accc4ab3368458bf102c7c3fb9abec1
+  data.tar.gz: d21be140d7517554a89346951de8a2141daafa6dcd2b5a93164fd46058f54c73e34e6a467be601307d42fc7f3632d6f776d5f01f1c83ff6fb5adbae8c650eea4

data/lib/a_b_split/configuration.rb

@@ -3,7 +3,7 @@ module ABSplit
     attr_accessor :experiments
 
     def initialize
-      @experiments = {}
+      @experiments = Hash.new
     end
   end
 end

data/lib/a_b_split/functions/heaviside_weighted_split.rb

@@ -0,0 +1,49 @@
+require 'bigdecimal'
+require_relative 'weighted_split'
+
+module ABSplit
+  module Functions
+    class HeavisideWeightedSplit < WeightedSplit
+      MAX_HASH_VALUE = ('f' * 64).to_i(16)
+      
+      class << self
+        protected 
+
+        def select_experiment_for(value, experiments)
+          x = value.is_a?(Numeric) ? value : hash(value)
+
+          heaviside(x, experiments)
+        end
+
+        private
+
+        def hash(value)
+          (sha256(value) - (MAX_HASH_VALUE / 2)).to_f / (MAX_HASH_VALUE / 2)
+        end
+
+        def sha256(value)
+          Digest::SHA256.hexdigest(value.to_s).to_i(16)
+        end
+
+        def heaviside(value, experiments)
+          x = sigmoid(value)
+          accumulated_percentages = 0
+
+          experiments.each do |experiment|
+            accumulated_percentages += percentage(experiment)
+
+            return experiment['name'] if x < accumulated_percentages
+          end
+        end
+
+        def percentage(experiment)
+          experiment['weight'].to_f / 100
+        end
+        
+        def sigmoid(x)
+          BigDecimal.new("#{1.0/(1 + Math.exp(-2 * x))}")
+        end
+      end
+    end
+  end
+end

data/lib/a_b_split/functions/md5_weighted_split.rb

@@ -0,0 +1,40 @@
+require 'digest'
+require_relative 'weighted_split'
+
+module ABSplit
+  module Functions
+    class Md5WeightedSplit < WeightedSplit
+
+      MAX_HASH_VALUE = ('f' * 32).to_i(16)
+
+      class << self
+        protected
+        def select_experiment_for(value, experiments)
+          weight = weight(value)
+          experiments = calculate_markers experiments
+          experiments.each do |experiment|
+            return experiment['name'] if weight <= experiment[:marker]
+          end
+          experiments.last['name']
+        end
+
+        def weight(value)
+          100 * hash(value).to_f / MAX_HASH_VALUE
+        end
+
+        def hash(value)
+          Digest::MD5.hexdigest(value.to_s).to_i(16)
+        end
+
+        def calculate_markers(experiments)
+          cumulative = 0
+          experiments.map do |experiment|
+            cumulative += experiment['weight']
+            { marker: cumulative }.merge(experiment)
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/a_b_split/functions/weighted_split.rb

@@ -2,61 +2,66 @@ module ABSplit
   module Functions
     class WeightedSplit
       MAX_POSITIONS = (9999999999999999999 * 2) + 1 #capacity of Fixnum
-      
-      def self.value_for(x, *params)
-        given_weights = validate(params)
-        
-        experiments = split_weights(params, params.size, given_weights)
 
-        select_experiment_for(x, experiments)
-      end
+      class << self 
 
-      private
+        def value_for(x, *params)
+          given_weights = validate(params)
 
-      def self.validate(experiments)
-        given_weights = experiments.each_with_object([]) do |param, memo| 
-          memo << param['weight'] if param.has_key?('weight')
-        end
+          experiments = split_weights(params, params.size, given_weights)
 
-        unless experiments.any? && experiments.size > 1 && given_weights.reduce(0, &:+) <= 100
-          raise ABSplit::NoValidExperiment
+          select_experiment_for(x, experiments)
         end
 
-        given_weights
-      end
+        protected
 
-      def self.markers(experiments)
-        experiments.map do |experiment| 
-          (MAX_POSITIONS * (experiment['weight'] / 100)) - ( MAX_POSITIONS / 2)
-        end
-      end
+        def validate(experiments)
+          given_weights = experiments.each_with_object([]) do |param, memo| 
+            memo << param['weight'] if param.has_key?('weight')
+          end
 
-      def self.select_experiment_for(x, experiments)
-        x_position = x.hash
-        
-        markers(experiments).each_with_index do |limit, i|
-          if x_position <= limit
-            return experiments[i]['name']
+          unless experiments.any? && experiments.size > 1 && given_weights.reduce(0, &:+) <= 100
+            raise ABSplit::NoValidExperiment
           end
+
+          given_weights
         end
 
-        experiments.last['name']
-      end
+        def split_weights(experiments, parts, given_percentage)
+          return experiments if given_percentage.size >= parts
+
+          missing_weights = parts - given_percentage.size
+          missing_percentage = 100 - given_percentage.reduce(0, &:+)
 
-      def self.split_weights(experiments, parts, given_percentage)
-        return experiments if given_percentage.size >= parts
+          experiments.map do |experiment| 
+            if experiment['weight']
+              experiment['weight'] = experiment['weight'].to_f
+            else
+              experiment['weight'] = missing_percentage.to_f / missing_weights.to_f
+            end
 
-        missing_weights = parts - given_percentage.size
-        missing_percentage = 100 - given_percentage.reduce(0, &:+)
+            experiment
+          end
+        end
+        
+        def select_experiment_for(x, experiments)
+          x_position = x.hash
 
-        experiments.map do |experiment| 
-          if experiment['weight']
-            experiment['weight'] = experiment['weight'].to_f
-          else
-            experiment['weight'] = missing_percentage.to_f / missing_weights.to_f
+          markers(experiments).each_with_index do |limit, i|
+            if x_position <= limit
+              return experiments[i]['name']
+            end
           end
 
-          experiment
+          experiments.last['name']
+        end
+
+        private
+
+        def markers(experiments)
+          experiments.map do |experiment| 
+            (MAX_POSITIONS * (experiment['weight'] / 100)) - ( MAX_POSITIONS / 2)
+          end
         end
       end
     end

data/lib/a_b_split/test.rb

@@ -1,11 +1,41 @@
 module ABSplit
   module Test
-    def self.split(name, x)
-      experiment = ABSplit.configuration.experiments[name]
+    extend self
+
+    def split(name, x)
+      self.experiment = find(name)
 
       raise ABSplit::NoValidExperiment unless experiment
 
-      ABSplit::Functions::WeightedSplit.value_for(x,*experiment)
+      function.value_for(x,*options)
+    end
+
+    private
+
+    attr_accessor :experiment
+
+    def find(experiment)
+      ABSplit.configuration.experiments[experiment]
+    end
+
+    def function
+      function = 'WeightedSplit'
+
+      unless experiment.is_a?(Array)
+        function = experiment['algorithm'] if experiment['algorithm']
+
+        begin
+          ABSplit::Functions.const_get(function)
+        rescue NameError
+          raise ABSplit::NoValidExperiment
+        end
+      end
+
+      ABSplit::Functions.const_get(function)
+    end
+
+    def options
+      experiment.is_a?(Array) ? experiment : experiment['options']
     end
   end
 end

data/lib/a_b_split.rb

@@ -15,8 +15,8 @@ module ABSplit
   attr_accessor :configuration
 
   def configure
-    self.configuration ||= Configuration.new
-    
     yield(configuration) if block_given?
   end
 end
+
+ABSplit.configuration = ABSplit::Configuration.new

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: a_b_split
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Enrique Figuerola
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-29 00:00:00.000000000 Z
+date: 2014-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -61,7 +61,8 @@ files:
 - lib/a_b_split.rb
 - lib/a_b_split/configuration.rb
 - lib/a_b_split/functions.rb
-- lib/a_b_split/functions/sigmoid.rb
+- lib/a_b_split/functions/heaviside_weighted_split.rb
+- lib/a_b_split/functions/md5_weighted_split.rb
 - lib/a_b_split/functions/weighted_split.rb
 - lib/a_b_split/test.rb
 homepage: https://github.com/emfigo/absplit
@@ -76,7 +77,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/a_b_split/functions/sigmoid.rb

@@ -1,11 +0,0 @@
-require 'bigdecimal'
-
-module ABSplit
-  module Functions
-    class Sigmoid
-      def self.value_for(x, *params)
-        BigDecimal.new("#{1.0/(1 + Math.exp(-2 * x))}")
-      end
-    end
-  end
-end