super_random 3.0.230113 → 3.2.230116

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 313ffa9d968e2c7b511fc80ec9a0b6c3de755fe0dd9ed51531448e9f8768d393
-  data.tar.gz: 43cae93ca8d339bd61018fa3b93806426ad7a8bc77161a52309e23b99f0aeedc
+  metadata.gz: 80443021c230106600a502974f5ae31b39f6e6f22b5c1e50eef7a00f03b8c9b9
+  data.tar.gz: c4133b454e2e339d5f59d9d64da877fa3ae8831fe701b9846bd86d0cd79906f1
 SHA512:
-  metadata.gz: 262c9131cc290b6df1cb1b68b54aaa2fb0cd60b6288c33facd07761e1f80802747a0555db7ec7edb9dd5146ecd088c463b5347a5dce2f2da263518964740e3a0
-  data.tar.gz: 352bcace20e9b6f2250c55000a69d2fa51c5f8db3b8a0f7c7474be068d2698d0622d7759c9acfd3cb2e4fa2c2b0fb3a81bfd60fee7390562c1b0078f001f4c84
+  metadata.gz: eee1ab617d8e57d836f519f96c504ba3e1bb8331ab3e7e300b3cf8360711e4fe688016af2fe37c0ef3f5fb60b74f7883b36c17ccfd496a4a227d416ddf0f8489
+  data.tar.gz: 3cee029f0a3ad6ee2a730934112b91a7997ac55ce0cc760ce17fde375ef5fb87fb0b88cc94dbc90dd73d1dbbb10c63f49467d61fb1f04a878840ad0b42b5afda

data/README.md

@@ -1,6 +1,6 @@
 # SuperRandom
 
-* [VERSION 3.0.230113](https://github.com/carlosjhr64/super_random/releases)
+* [VERSION 3.2.230116](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.2.230116"
 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.2.230116'
   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,69 @@ class SuperRandom
     bytes.map{_1.to_s(16).rjust(2,'0')}.join
   end
 
+  def integer
+    hexadecimal.to_i(16)
+  end
+
+  def xy
+    hex = hexadecimal
+    x = hex[0...64].to_i(16)
+    y = hex[64..128].to_i(16)
+    return x,y
+  end
+
+  def integer2
+    # An alternate way to generate an integer
+    x,y = xy
+    # I think this is Binomial(Gaussian in the limit) around zero?
+    x - y
+  end
+
+  def float
+    Rational(integer, DIV).to_f
+  end
+
+  def float2
+    # An alternate way to generate a float...
+    x,y = xy
+    # ...but 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.2.230116
 platform: ruby
 authors:
 - CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-13 00:00:00.000000000 Z
+date: 2023-01-16 00:00:00.000000000 Z
 dependencies: []
 description: |
   You can't get more random than random, but you can try really, really, really hard.