super_random 3.0.230113 → 3.1.230114

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 313ffa9d968e2c7b511fc80ec9a0b6c3de755fe0dd9ed51531448e9f8768d393
-  data.tar.gz: 43cae93ca8d339bd61018fa3b93806426ad7a8bc77161a52309e23b99f0aeedc
+  metadata.gz: da086dfbbc9f424f5c8f7f35e38fc1be67633986797aea732af695c0ed4a8b67
+  data.tar.gz: ed4274a6e0b5b113c37c9adc4b20f9f96eacdeb5798e79235d023b6c5683f847
 SHA512:
-  metadata.gz: 262c9131cc290b6df1cb1b68b54aaa2fb0cd60b6288c33facd07761e1f80802747a0555db7ec7edb9dd5146ecd088c463b5347a5dce2f2da263518964740e3a0
-  data.tar.gz: 352bcace20e9b6f2250c55000a69d2fa51c5f8db3b8a0f7c7474be068d2698d0622d7759c9acfd3cb2e4fa2c2b0fb3a81bfd60fee7390562c1b0078f001f4c84
+  metadata.gz: 78284485c7c649b00f1916d6a7b946f9673ab223f01f8b28bc227975da9154ccbc87bfb1af76eb36a0ad378c4c222c9135b239cad57b655f02d6860c146f9205
+  data.tar.gz: bab65a30405474b92539bfffdbd82fca278882c0be7d45f74d12c57d2c0f7ffc874cfd7e9ba0c0d1cc5b949d909adf298aa036b9974cf35c8dd248340f929be3

data/README.md

@@ -1,6 +1,6 @@
 # SuperRandom
 
-* [VERSION 3.0.230113](https://github.com/carlosjhr64/super_random/releases)
+* [VERSION 3.1.230114](https://github.com/carlosjhr64/super_random/releases)
 * [github](https://github.com/carlosjhr64/super_random)
 * [rubygems](https://rubygems.org/gems/super_random)
 
@@ -17,7 +17,7 @@ You can't get more random than random, but you can try really, really, really ha
 ## SYNOPSIS:
 ```ruby
 require 'super_random'
-SuperRandom::VERSION              #=> "3.0.230113"
+SuperRandom::VERSION              #=> "3.1.230114"
 SuperRandom::DEFAULT_SOURCES      #~> www.random.org
 super_random = SuperRandom.new
 super_random.sources              #~> www.random.org
@@ -34,7 +34,10 @@ super_random.source_count         #=> 0
 super_random.byte_count           #=> 0
 # Snapshots from your webcam can be a good entropy source:
 super_random = SuperRandom.new('/var/lib/motion/lastsnap.jpg')
-super_random.sources #=> ["/var/lib/motion/lastsnap.jpg"]
+super_random.sources              #=> ["/var/lib/motion/lastsnap.jpg"]
+# Dice!
+d6 = super_random.dice(6)
+d6.roll                           #~> ^[123456]$
 ```
 ## METHODOLOGY:
 

data/lib/super_random.rb

@@ -6,7 +6,7 @@ require 'digest'
 #`ruby`
 
 class SuperRandom
-  VERSION = '3.0.230113'
+  VERSION = '3.1.230114'
   DEFAULT_SOURCES = [
     'https://www.random.org/strings/?num=10&len=20&digits=on&upperalpha=on&loweralpha=on&unique=on&format=plain&rnd=new',
   ]
@@ -34,17 +34,57 @@ class SuperRandom
     bytes.map{_1.to_s(16).rjust(2,'0')}.join
   end
 
+  def integer
+    hexadecimal.to_i(16)
+  end
+
+  def float
+    Rational(integer, DIV).to_f
+  end
+
+  def float2
+    # An alternate way to generate a float but...
+    hex = hexadecimal
+    x = hex[0...64].to_i(16)
+    y = hex[64..128].to_i(16)
+    # ...what distribution is this?
+    Rational(x,y).to_f
+  rescue ZeroDivisionError
+    # Fat chance!
+    return 0 if x == 0
+    1.0/0.0
+  end
+
   def random_number(scale=1.0)
     case scale
     when Float
-      return scale * Rational(hexadecimal.to_i(16), DIV)
+      return scale * float
     when Integer
-      return ((hexadecimal.to_i(16) + SecureRandom.random_number(scale)) % scale)
+      return ((integer + SecureRandom.random_number(scale)) % scale)
     end
     raise "rand(scale Integer|Float)"
   end
   alias rand random_number
 
+  class Dice
+    private def set_big
+      @big = @rng.integer + SecureRandom.random_number(@sides)
+    end
+    def initialize(sides, minimum:1, rng:SuperRandom.new)
+      @sides,@minimum,@rng = sides,minimum,rng
+      set_big
+    end
+    def roll
+      @big,roll = @big.divmod(@sides)
+      return roll+@minimum
+    ensure
+      set_big unless @big>0
+    end
+  end
+  def dice(sides, minimum:1)
+    Dice.new(sides, minimum:minimum, rng:self)
+  end
+
   private
 
   SHASUM = Digest::SHA2.new(512)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: super_random
 version: !ruby/object:Gem::Version
-  version: 3.0.230113
+  version: 3.1.230114
 platform: ruby
 authors:
 - CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-13 00:00:00.000000000 Z
+date: 2023-01-14 00:00:00.000000000 Z
 dependencies: []
 description: |
   You can't get more random than random, but you can try really, really, really hard.