pick_me_too 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac4906dd27b93c363b8e9af9e82ffe636c3149519d79654a7b8a2f0a2bdfdf25
-  data.tar.gz: a902f070e98dc4fab62695fe7e556e499ad33c3d1dd2b0dc21764923b37f310f
+  metadata.gz: 52db253007776ea2ede6caa43361e3e260660accdd4a0b1eb1439532f1ef92d3
+  data.tar.gz: 7f370bb747440c33062b8193a3edffb2fe0ac752493735366ea4d7161ded0c4a
 SHA512:
-  metadata.gz: 73f4816247afc780c1dae9c5399fbc1280db8795d191f575fd4829d39ea8b5f39f61974d9953a0883f25160dcd256feabefe0e75ddc323728523c9fa3a2c997c
-  data.tar.gz: ef409f69716637d562c45b52d2ea71843e2bfb3fe568d2dfd82447084a27cd93cae9fdf99f1a4decbe37036db1639d2332fe6debfb13ed5f268c5dffae632456
+  metadata.gz: 4f70d7864e25ca65ea5ca660c1964f0e79229da429e2414539ffaf3a65da50b2a30f70f186266532adbf6115b4e7e7a9bbd7b0b8727994c690876e9648ff0ab7
+  data.tar.gz: bcf37dedb54b3304367799a16c3521541fa57c0db4dd4e819220dcb9ca85ff804c37e1b026e7867cf90a8990575d10e2b7ac0b452433d74760a358301b1eec8f

data/CHANGES.md

@@ -1,4 +1,6 @@
 # Change Log
 
+## 1.1.0 *2022-8-21*
+* added the `randomize!` method
 ## 1.0.0 *2022-8-14*
 * initial release

data/README.md

@@ -47,7 +47,7 @@ of frequencies:
 
 What you need is something that will randomly pick these things for you with the frequencies you specify.
 
-One way to do this would be to make an array, filling it with the items according to the frequencies specified
+One way to do this would be to make an array, fill it with the items according to the frequencies specified,
 and then pick randomly from the array:
 
 ```ruby
@@ -72,7 +72,7 @@ This is the "[urn](https://en.wikipedia.org/wiki/Urn_problem)" containing the it
 
 "Fill" the urn.
 
-The required `frequencies` parameter must be something that is effectivly a list of pairs:
+The required `frequencies` parameter must be something that is effectively a list of pairs:
 things to pick paired with their frequency. The "frequency" is just any positive number.
 
 The optional `rnd` parameter is a `Proc` that when called returns a number, ideally in the interval
@@ -88,6 +88,18 @@ This constructor method will raise a `PickMeToo::Error` if
 
 Draw an item from the urn.
 
+## `PickMeToo#randomize!([rnd])`
+
+Replace the random number generator.
+If the optional argument is omitted, the replacement is just
+
+```ruby
+-> { rand }
+```
+
+This is useful if you want to switch from a seeded random number generator
+to something more truly random.
+
 # Installation
 
 `pick_me_too` is available as a gem, so one installs it as one does gems.

data/lib/pick_me_too.rb

@@ -2,7 +2,7 @@
 
 ##
 # An "urn" from which you can pick things with specified frequencies.
-# 
+#
 #   require 'pick_me_too'
 #
 #   wandering_monsters = PickMeToo.new({goblin: 10, bugbear: 2, orc: 5, spider: 3, troll: 1})
@@ -17,14 +17,14 @@
 # probability the next thing you pick is also a cat, and the urn will never be picked empty. (And of course
 # this is all a metaphor.)
 class PickMeToo
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 
   class Error < StandardError; end
 
   ##
   # "Fill" the urn.
   #
-  # The required frequencies parameter must be something that is effectivly a list of pairs:
+  # The required frequencies parameter must be something that is effectively a list of pairs:
   # things to pick paired with their frequency. The "frequency" is just any positive number.
   #
   # The optional rnd parameter is a Proc that when called returns a number, ideally in the interval
@@ -46,7 +46,7 @@ class PickMeToo
       balanced_binary_tree = bifurcate(frequencies.dup)
       probability_tree = probabilities(frequencies, balanced_binary_tree)
       # compile everything into a nested ternary expression
-      @picker = eval "->(p) { #{ternerize(probability_tree)} }"
+      @picker = eval "->(p) { #{ternarize(probability_tree)} }"
     end
   end
 
@@ -56,6 +56,19 @@ class PickMeToo
     @objects[@picker.call(@rnd.call)]
   end
 
+  ##
+  # Replace the random number generator.
+  #
+  # If the optional argument is omitted, the replacement is just
+  #
+  #   -> { rand }
+  #
+  # This is useful if you want to switch from a seeded random number generator
+  # to something more truly random.
+  def randomize!(rnd = -> { rand })
+    @rnd = rnd
+  end
+
   private
 
   # sanity check and normalization of frequencies
@@ -73,10 +86,10 @@ class PickMeToo
   end
 
   # reduce the probability tree to nested ternary expressions
-  def ternerize(ptree)
+  def ternarize(ptree)
     p, left, right = ptree.values_at :p, :left, :right
-    left = left.is_a?(Numeric) ? left : ternerize(left)
-    right = right.is_a?(Numeric) ? right : ternerize(right)
+    left = left.is_a?(Numeric) ? left : ternarize(left)
+    right = right.is_a?(Numeric) ? right : ternarize(right)
     "(p > #{p} ? #{right} : #{left})"
   end
 

data/pick_me_too.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |s|
   s.require_paths         = ['lib']
 
   s.add_development_dependency 'bundler', '~> 1.7'
-  s.add_development_dependency 'byebug', '~> 9.1.0'
+  s.add_development_dependency 'byebug', '~> 9.1', '>= 9.1.0'
   s.add_development_dependency 'json', '~> 2'
   s.add_development_dependency 'minitest', '~> 5'
   s.add_development_dependency 'rake', '~> 10.0'

data/test/basic_test.rb

@@ -19,7 +19,7 @@ class BasicTest < Minitest::Test
 
   def test_hash
     rnd = Random.new 1
-    picker = PickMeToo.new({'cat' => 2, 'dog' => 1}, -> { rnd.rand })
+    picker = PickMeToo.new({ 'cat' => 2, 'dog' => 1 }, -> { rnd.rand })
     counter = Hash.new(0)
     3000.times { counter[picker.pick] += 1 }
     assert_equal 2, (counter['cat'] / 1000.0).round, 'right number of cats'
@@ -70,4 +70,19 @@ class BasicTest < Minitest::Test
       PickMeToo.new([['foo', nil]])
     end
   end
+
+  def test_randomize
+    rnd1 = Random.new 1
+    rnd2 = Random.new 1
+    rnd3 = Random.new 2
+    picker1 = PickMeToo.new({ foo: 1, bar: 2, baz: 3 }, -> { rnd1.rand })
+    picker2 = PickMeToo.new({ foo: 1, bar: 2, baz: 3 }, -> { rnd2.rand })
+    ar1 = Array.new(100) { picker1.pick }
+    ar2 = Array.new(100) { picker2.pick }
+    assert_equal ar1, ar2, 'with the same seeds we get the same sequences'
+    picker2.randomize! -> { rnd3.rand }
+    ar1 = Array.new(100) { picker1.pick }
+    ar2 = Array.new(100) { picker2.pick }
+    refute_equal ar1, ar2, 'if we randomize a picker, we get a new sequence'
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pick_me_too
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - David F. Houghton
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-14 00:00:00.000000000 Z
+date: 2022-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -29,6 +29,9 @@ dependencies:
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.1'
+    - - ">="
       - !ruby/object:Gem::Version
         version: 9.1.0
   type: :development
@@ -36,6 +39,9 @@ dependencies:
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.1'
+    - - ">="
       - !ruby/object:Gem::Version
         version: 9.1.0
 - !ruby/object:Gem::Dependency
@@ -101,7 +107,7 @@ homepage: https://github.com/dfhoughton/pick_me_too
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -116,8 +122,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
 specification_version: 4
 summary: Randomly select items from a list with specified frequencies
 test_files: