super_random 1.1.0 → 1.2.200123

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83691b6150693c16ecc7f602259eceba24a343e7583db204f388015bfe133796
-  data.tar.gz: efa9698299c61b3df708f3c8392635d76373e4654129ef093737c7da5a1a9e0d
+  metadata.gz: aeb192c166b91d82fb0a4b535d851a5479c5bae43bf4a37d607ae199b128d83d
+  data.tar.gz: 6fb7ad8629f9775183a65c040dc762d48e178a761c545008028e57c0002162dd
 SHA512:
-  metadata.gz: 6c9a8746336cdf86a2643790b0406345ee859ccd5de84868ea834d4e4260908016df5e1b917da9ebbd8848885d7ce1e394c5be17382509b79c773445cbf75dfe
-  data.tar.gz: 1437d184fbca7782cf65a2f05d7b6cf424e396de112ac2e928db08836171b5d86fc2da5f015e3962155602c59e693fb8eb97dc5bb8b8a639ff4dc39c5cdb86c7
+  metadata.gz: c51049b6220c0c971146cd2ddc0463dcbd7037c7bc7695aca8a50653d8acd22cc2964d85f66d667ad311526f2e0a8748d0e4a2e501f9621aa64db0f524d78883
+  data.tar.gz: f583c0095ca47c209730afa445bca8304f041d55de8c0f26e599e9cac7770bbdc3f4001e2e9fc82fe8e24ea70a5c9063d01e12e616a6708bc88dcfd71c990f8d

data/README.md

@@ -1,6 +1,7 @@
 # SuperRandom
 
-* [github](https://www.github.com/carlosjhr64/super_random)
+* [VERSION 1.2.200123](https://github.com/carlosjhr64/super_random/releases)
+* [github](https://github.com/carlosjhr64/super_random)
 * [rubygems](https://rubygems.org/gems/super_random)
 
 ## DESCRIPTION:
@@ -11,18 +12,26 @@ SuperRandom combines five online real random services to create a more perfect r
 
 ## SYNOPSIS:
 
-    require 'super_random' #=> true
-    super_random = SuperRandom.new # => #<SuperRandom:...
+    require 'super_random'
+    super_random = SuperRandom.new
 
-    # bytes returns 32 bytes by default (256 bits).
-    super_random.bytes # => [123, 219, 128, ...,  248, 164, 100]
+    super_random.bytes(32) #~> ^\[\d+(, \d+){31}\]$
+    # Example:
+    # [142, 36, 107, 199, 1, 222, 69, 238, 130, 159, 236, 201, 199,
+    #   33, 237, 166, 189, 166, 95, 246, 111, 103, 113, 126, 27, 31,
+    #  244, 215, 200, 60, 255, 184]
 
-    # hexadecimal returns a 32 bytes hexadecimal by default.
-    super_random.hexadecimal #=> "2ae...37b"
+    super_random.hexadecimal(32) #~> ^\h{64}$
+    # Example:
+    # "3e0dffe42c08b849dc3c1290e7aa87dff4ad3037b29694136786a4db1e3efab8"
 
-    # rand as the typical use
-    super_random.rand #=> 0.16882225652425537
-    super_random.rand(100) #=> 85
+    super_random.random_number(100.0) #~> ^\d{1,2}\.\d+$
+    # Example:
+    # 16.882225652425537
+
+    super_random.random_number(100) #~> ^\d{1,2}$
+    # Example:
+    # 85
 
     # The "services" attribute gives the number of online services used.
     # It's possible for a service to fail.
@@ -37,7 +46,7 @@ SuperRandom combines five online real random services to create a more perfect r
 
 (The MIT License)
 
-Copyright (c) 2017 carlosjhr64
+Copyright (c) 2020 carlosjhr64
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/super_random.rb

@@ -1,5 +1,5 @@
 class SuperRandom
-  VERSION = '1.1.0'
+  VERSION = '1.2.200123'
 end
 
 # Standard Libraries

data/lib/super_random/super_random.rb

@@ -1,4 +1,5 @@
 class SuperRandom
+  DEFAULT_BYTES = 32
 
   # http://qrng.anu.edu.au/index.php
   # https://qrng.anu.edu.au/API/api-demo.php
@@ -77,7 +78,7 @@ class SuperRandom
     @services = 0
   end
 
-  def bytes(n=32)
+  def bytes(n=DEFAULT_BYTES)
     @randomness = 0.0
     @services = 0
 
@@ -122,13 +123,43 @@ class SuperRandom
     return a
   end
 
-  def hexadecimal(n=32)
+  def hexadecimal(n=DEFAULT_BYTES)
     bytes(n).map{|i|i.to_s(16).rjust(2,'0')}.join
   end
 
-  def rand(m=nil, n=6)
-    div = n.times.inject(''){|s,i| s+'FF'}.to_i(16).to_f
-    r = hexadecimal(n).to_i(16).to_f / div
-    m.nil? ? r : (m*r).to_i
+  def random_number(scale=1.0, minbytes=6, maxbytes=[minbytes,DEFAULT_BYTES].max)
+    case scale
+    when Float
+      div = minbytes.times.inject(''){|s,i| s+'FF'}.to_i(16)
+      den = hexadecimal(minbytes).to_i(16)
+      return  scale * den.to_f / div.to_f
+    when Integer
+      n = n0 = Math.log(scale, 256).ceil
+      e = e0 = 256**n
+      r = r0 = e0 % scale
+      while r > 0
+        n0 += 1
+        e0 *= 256
+        r0 = e0 % scale
+        if r0 <= r
+          # break if repeating pattern with big enough integer
+          break if r0 == r and n0 > minbytes
+          r,n,e = r0,n0,e0
+        end
+        break if n0 >= maxbytes
+      end
+      max = (e/scale)*scale
+      loop do
+        number = hexadecimal(n).to_i(16)
+        return number % scale if number < max
+        # On a relatively small chance that we're above max...
+        if @nevermind
+          warn "using SecureRandom.random_number(#{scale})"
+          return SecureRandom.random_number(scale)
+        end
+      end
+    end
+    raise "rand(scale Integer|Float)"
   end
+  alias rand random_number
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: super_random
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.200123
 platform: ruby
 authors:
 - carlosjhr64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-18 00:00:00.000000000 Z
+date: 2020-01-23 00:00:00.000000000 Z
 dependencies: []
 description: |
   You can't get more random than random, but you can try really, really, really hard.
@@ -41,8 +41,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.6.5p114 (2019-10-01 revision 67812) [x86_64-linux]'
-rubygems_version: 3.0.3
+- 'ruby: ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-linux]'
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: You can't get more random than random, but you can try really, really, really