eenie_meenie 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.sw?

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+0.0.1 - Initial release, allows you to initialize an instance of Rubeuler::Problem with required options `:number` (int) and `:answer` (string of ruby code). Answer is evaluated and compared to answer predefined in Rubeuler::Problem#solutions method.   Result is returned indicating success/failure and the time elapsed when running the code in `:answer`
+
+0.0.2 - Fixed Rakefile (gave myself the ability to use `rake release`); Updated description in gemspec
+
+0.0.3 - Moved Rubeuler::Problem#solutions to Rubeuler::Solution#for_problem to make the intended use more intuitive
+
+0.0.4 - Add tests using minitest
+
+0.0.5 - Feature: Track other variables... the options `tracked: {foo: @foo}` would track a variable set as `@foo` in Rubeuler::Problem's `:answer` argument
+				Improve on tests, improve timer by moving Benchmark closer to code being evaluated
+
+0.0.6 - Reverting the change to the Benchmark implementation from 0.0.5
+        

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    eenie_meenie (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.7)
+    method_source (0.8)
+    minitest (3.5.0)
+    pry (0.9.10)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.3.1)
+    pry (0.9.10-java)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.3.1)
+      spoon (~> 0.0)
+    rake (0.9.2.2)
+    slop (3.3.3)
+    spoon (0.0.1)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  eenie_meenie!
+  minitest
+  pry
+  rake

data/README.md

@@ -0,0 +1,13 @@
+EenieMeenie
+========
+
+This tool was written in order to play with some simple methods for assigning members of a population to one of two groups. The goal is to provide an algorithm that will limit the user's ability to predict which group a member will be assigned.
+
+Installation
+------------
+
+EenieMeenie is a Ruby gem, and can be installed using `gem install eenie_meenie`
+
+### Pull requests/issues
+
+Please submit any useful pull requests through GitHub. Please report any bugs using Github's issue tracker

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.pattern = 'test/**/*_test.rb'
+  t.libs.push 'test'
+end
+
+task :default => :test

data/eenie_meenie.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "eenie_meenie/version"
+
+Gem::Specification.new do |s|
+  s.name        = "eenie_meenie"
+  s.version     = EenieMeenie::VERSION
+  s.authors     = ["Tad Hosford"]
+  s.email       = ["tad.hosford@gmail.com"]
+  s.homepage    = "http://github.com/rthbound/eenie_meenie"
+  s.description = %q{ Attempts to provide a random but (mostly)
+                      even distribution of samples amongst
+                      specified groups
+                    }
+  s.summary     = %q{ }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "minitest"
+
+  s.add_development_dependency "rake"
+  s.add_development_dependency "pry"
+end

data/lib/eenie_meenie/assignment.rb

@@ -0,0 +1,62 @@
+module EenieMeenie
+  class Assignment < ::EenieMeenie::Base
+    def initialize(options)
+      load_options(:groups, :member_class, options)
+      raise ArgumentError unless @member_class.respond_to?(:group)
+    end
+
+    def execute!
+      group = assign
+    end
+
+    private
+
+    def assign
+      group = coercion_threshold_reached? ? assign_with_coercion : assign_without_coercion
+
+      group
+    end
+
+    def count_for_group(group)
+      @member_class.where(group: group).count
+    end
+
+    def assign_without_coercion
+      selected_group = @groups.sample
+      if rand(expected_population) >= (expected_population / 2)
+        group = selected_group
+      else
+        group = the_other_group(selected_group)
+      end
+    end
+
+    def assign_with_coercion
+      group = @groups.sample
+      group_tally = count_for_group(group)
+      other_group = (@groups - [group]).first
+      group = other_group if group_tally > count_for_group(other_group) + rand(leeway)
+
+      group
+    end
+
+    def expected_population
+      60000.to_f
+    end
+
+    def current_population
+      @member_class.count.to_f
+    end
+
+    def leeway
+      ((current_population / 2 ) * 0.01).round
+    end
+
+    def the_other_group group
+      (@groups - [group]).first
+    end
+
+    def coercion_threshold_reached?
+      (current_population / expected_population) >= 0.9
+    end
+  end
+end

data/lib/eenie_meenie/base.rb

@@ -0,0 +1,13 @@
+module EenieMeenie
+  class Base
+    def load_option(option, options)
+      instance_variable_set("@#{option}", options.fetch(option.to_sym) { raise "Missing required option: #{option}" } )
+    end
+
+    def load_options(*option_names, options)
+      option_names.each{|o| load_option(o, options) }
+
+      option_names << instance_variable_set("@tracked", options[:tracked]) if options[:tracked]
+    end
+  end
+end

data/lib/eenie_meenie/miny_moe.rb

@@ -0,0 +1,14 @@
+module EenieMeenie
+  class MinyMoe < ::EenieMeenie::Base
+    def initialize(options)
+      load_options(:groups, :population, :sorter, options)
+    end
+
+    def execute!
+      groups = @sorter.new(groups: @groups, population: @population).sort
+      return EenieMeenie::Result.new(groups: groups, population: @population)
+    end
+
+    private
+  end
+end

data/lib/eenie_meenie/result.rb

@@ -0,0 +1,22 @@
+module EenieMeenie
+  class Result
+    def initialize(options)
+      @groups = options[:groups]
+      @population = options[:population]
+      @imbalance = @groups.values.inject(:-).abs
+      @relative_imbalance = (@imbalance / @population).to_f
+    end
+
+    def groups
+      @groups
+    end
+
+    def imbalance
+      @imbalance
+    end
+
+    def relative_imbalance
+      @relative_imbalance
+    end
+  end
+end

data/lib/eenie_meenie/sorters/bucket_shuffle.rb

@@ -0,0 +1,20 @@
+module EenieMeenie
+  module Sorters
+    class PureRandom < EenieMeenie::Base
+      def initialize(*args, options)
+        load_options(:groups, :population, options)
+      end
+
+      def sort
+        results = {}
+        @groups.each { |group| results.merge!(group => 0) }
+
+        @population.times do |i|
+          results[(rand(@population) >= (@population / 2) ? @groups.first : @groups.last)] += 1
+        end
+        groups = results
+      end
+    end
+  end
+end
+

data/lib/eenie_meenie/sorters/late_coercion.rb

@@ -0,0 +1,61 @@
+module EenieMeenie
+  module Sorters
+    class LateCoercion < EenieMeenie::Base
+      def initialize(*args, options)
+        load_options(:groups, :population, options)
+      end
+
+      def sort
+        @results = {}
+        @groups.each { |group| @results.merge!(group => 0) }
+
+        @population.times do |i|
+          @results[assign] += 1
+        end
+        groups = @results
+      end
+
+      def assign
+        coercion_threshold_reached? ? assign_with_coercion : assign_without_coercion
+      end
+
+      def assign_without_coercion
+        selected_group = @groups.sample
+        if rand(@population) >= (@population / 2)
+          group = selected_group
+        else
+          group = the_other_group(selected_group)
+        end
+      end
+
+      def the_other_group group
+        (@groups - [group]).first
+      end
+
+      def assign_with_coercion
+        group = @groups.sample
+        group_tally = count_for_group(group)
+        other_group = (@groups - [group]).first
+        group = other_group if group_tally > count_for_group(other_group) + rand(leeway)
+
+        group
+      end
+
+      def count_for_group(group)
+        @results[group].to_f
+      end
+
+      def leeway
+        ((current_population / 2 ) * 0.01).round
+      end
+
+      def current_population
+        @results.values.inject(&:+).to_f
+      end
+
+      def coercion_threshold_reached?
+        (current_population / @population) >= 0.9
+      end
+    end
+  end
+end

data/lib/eenie_meenie/sorters/pick_a_group.rb

@@ -0,0 +1,23 @@
+module EenieMeenie
+  module Sorters
+    class PickAGroup < EenieMeenie::Base
+      def initialize(*args, options)
+        load_options(:groups, :population, options)
+      end
+
+      def sort
+        results = {}
+        @groups.each { |group| results.merge!(group => 0) }
+
+        @population.times do |i|
+          group = @groups.sample
+          other_group = (@groups - [group]).first
+          group = other_group if results.values.any? {|v| results[group] > v + rand(10) }
+          results[group] += 1
+        end
+        groups = results
+      end
+    end
+  end
+end
+

data/lib/eenie_meenie/sorters/pure_random.rb

@@ -0,0 +1,20 @@
+module EenieMeenie
+  module Sorters
+    class PureRandom < EenieMeenie::Base
+      def initialize(*args, options)
+        load_options(:groups, :population, options)
+      end
+
+      def sort
+        results = {}
+        @groups.each { |group| results.merge!(group => 0) }
+
+        @population.times do |i|
+          results[(rand(@population) > (@population / 2) ? @groups.first : @groups.last)] += 1
+        end
+        groups = results
+      end
+    end
+  end
+end
+

data/lib/eenie_meenie/sorters/round_robin.rb

@@ -0,0 +1,20 @@
+module EenieMeenie
+  module Sorters
+    class RoundRobin < EenieMeenie::Base
+      def initialize(*args, options)
+        load_options(:groups, :population, options)
+      end
+
+      def sort
+        results = {}
+        @groups.each { |group| results.merge!(group => 0) }
+        @population.times do |i|
+          results[@groups[i % @groups.length]] += 1
+        end
+
+        groups = results
+      end
+    end
+  end
+end
+

data/lib/eenie_meenie/version.rb

@@ -0,0 +1,3 @@
+module EenieMeenie
+  VERSION = "0.0.1"
+end

data/lib/eenie_meenie.rb

@@ -0,0 +1,11 @@
+require "eenie_meenie/base"
+#require "eenie_meenie/miny_moe"
+#require "eenie_meenie/sorters/round_robin"
+#require "eenie_meenie/sorters/pure_random"
+#require "eenie_meenie/sorters/pick_a_group"
+#require "eenie_meenie/version"
+#require "eenie_meenie/result"
+
+Dir.glob(File.join(File.dirname(__FILE__), '/**/*.rb')) do |c|
+  require(c)
+end

data/test/eenie_meenie/miny_moe_test.rb

@@ -0,0 +1,13 @@
+require "minitest_helper"
+
+describe EenieMeenie::MinyMoe do
+  describe ".execute!" do
+    before do
+      @options = { population: 100, groups: ["Experimental", "Control"] }
+      @subject = EenieMeenie::MinyMoe
+    end
+    it "returns a result" do
+      @subject.new(@options.merge(sorter: EenieMeenie::Sorters::RoundRobin)).execute!.must_be_kind_of(EenieMeenie::Result)
+    end
+  end
+end

data/test/minitest_helper.rb

@@ -0,0 +1,12 @@
+# Testing frameworks
+require "minitest/spec"
+require "minitest/autorun"
+
+# Debugger
+require "pry"
+
+# The gem
+$: << File.dirname(__FILE__) + "/../lib"
+$: << File.dirname(__FILE__)
+
+require "eenie_meenie"

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: eenie_meenie
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+  - Tad Hosford
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-12-27 00:00:00 Z
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: minitest
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    type: :development
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: rake
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    type: :development
+    version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: pry
+    prerelease: false
+    requirement: &id003 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0"
+    type: :development
+    version_requirements: *id003
+description: " Attempts to provide a random but (mostly)\n                      even distribution of samples amongst\n                      specified groups\n                    "
+email: 
+  - tad.hosford@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+  - .gitignore
+  - CHANGELOG.md
+  - Gemfile
+  - Gemfile.lock
+  - README.md
+  - Rakefile
+  - eenie_meenie.gemspec
+  - lib/eenie_meenie.rb
+  - lib/eenie_meenie/assignment.rb
+  - lib/eenie_meenie/base.rb
+  - lib/eenie_meenie/miny_moe.rb
+  - lib/eenie_meenie/result.rb
+  - lib/eenie_meenie/sorters/bucket_shuffle.rb
+  - lib/eenie_meenie/sorters/late_coercion.rb
+  - lib/eenie_meenie/sorters/pick_a_group.rb
+  - lib/eenie_meenie/sorters/pure_random.rb
+  - lib/eenie_meenie/sorters/round_robin.rb
+  - lib/eenie_meenie/version.rb
+  - test/eenie_meenie/miny_moe_test.rb
+  - test/minitest_helper.rb
+homepage: http://github.com/rthbound/eenie_meenie
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: ""
+test_files: []
+