webget_ruby_secure_random 1.2.0

data.tar.gz.sig

@@ -0,0 +1,2 @@
+�����8��e
_�O@=�,N�Kj�gu �3�h���U�3��GYPX��7�4W�D_� �au8m�wxr��7�6ig[��`D�z�-JS�P),
+f������e���1�-2i��(�C
��é

data/lib/webget_ruby_secure_random.rb

@@ -0,0 +1,154 @@
+=begin rdoc
+
+= WebGet Ruby Gem: secure random number generator interface for Ruby 1.86 backported from 1.8.7
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright the original author; I merely made it into a gem.
+License:: CreativeCommons License, Non-commercial Share Alike
+License:: LGPL, GNU Lesser General Public License
+
+This gem is intended for use with Ruby 1.8.6 only.
+
+This gem is a backport of the built-in securerandom method from Ruby 1.8.7.
+
+This library is an interface for secure random number generator which is
+suitable for generating session key in HTTP cookies, etc.
+
+It supports following secure random number generators.
+
+  * openssl
+  * /dev/urandom
+
+Examples
+  SecureRandom.hex(10) => "52750b30ffbc7de3b362"
+  SecureRandom.hex(10) => "92b15d6c8dc4beb5f559"
+  SecureRandom.hex(11) => "6aca1b5c58e4863e6b81b8"
+  SecureRandom.hex(12) => "94b2fff3e7fd9b9c391a2306"
+  SecureRandom.hex(13) => "39b290146bea6ce975c37cfc23"
+
+Examples
+  SecureRandom.base64(10) => "EcmTPZwWRAozdA=="
+  SecureRandom.base64(10) => "9b0nsevdwNuM/w=="
+  SecureRandom.base64(10) => "KO1nIU+p9DKxGg=="
+  SecureRandom.base64(11) => "l7XEiFja+8EKEtY="
+  SecureRandom.base64(12) => "7kJSM/MzBJI+75j8"
+  SecureRandom.base64(13) => "vKLJ0tXBHqQOuIcSIg=="
+
+Examples
+  SecureRandom.random_bytes(10) => "\016\t{\370g\310pbr\301"
+  SecureRandom.random_bytes(10) => "\323U\030TO\234\357\020\a\337"
+
+=end
+
+
+begin
+  require 'openssl'
+rescue LoadError
+end
+
+module SecureRandom
+  # SecureRandom.random_bytes generates a random binary string.
+  #
+  # The argument n specifies the length of the result string.
+  #
+  # If n is not specified, 16 is assumed.
+  # It may be larger in future.
+  #
+  # If secure random number generator is not available,
+  # NotImplementedError is raised.
+  def self.random_bytes(n=nil)
+    n ||= 16
+    if defined? OpenSSL::Random
+      return OpenSSL::Random.random_bytes(n)
+    end
+    if !defined?(@has_urandom) || @has_urandom
+      @has_urandom = false
+      flags = File::RDONLY
+      flags |= File::NONBLOCK if defined? File::NONBLOCK
+      flags |= File::NOCTTY if defined? File::NOCTTY
+      flags |= File::NOFOLLOW if defined? File::NOFOLLOW
+      begin
+        File.open("/dev/urandom", flags) {|f|
+          unless f.stat.chardev?
+            raise Errno::ENOENT
+          end
+          @has_urandom = true
+          ret = f.readpartial(n)
+          if ret.length != n
+            raise NotImplementedError, "Unexpected partial read from random device"
+          end
+          return ret
+        }
+      rescue Errno::ENOENT
+        raise NotImplementedError, "No random device"
+      end
+    end
+    raise NotImplementedError, "No random device"
+  end
+
+  # SecureRandom.hex generates a random hex string.
+  #
+  # The argument n specifies the length of the random length.
+  # The length of the result string is twice of n.
+  #
+  # If n is not specified, 16 is assumed.
+  # It may be larger in future.
+  #
+  # If secure random number generator is not available,
+  # NotImplementedError is raised.
+  def self.hex(n=nil)
+    random_bytes(n).unpack("H*")[0]
+  end
+
+  # SecureRandom.base64 generates a random base64 string.
+  #
+  # The argument n specifies the length of the random length.
+  # The length of the result string is about 4/3 of n.
+  #
+  # If n is not specified, 16 is assumed.
+  # It may be larger in future.
+  #
+  # If secure random number generator is not available,
+  # NotImplementedError is raised.
+  def self.base64(n=nil)
+    [random_bytes(n)].pack("m*").delete("\n")
+  end
+
+  # SecureRandom.random_number generates a random number.
+  #
+  # If an positive integer is given as n,
+  # SecureRandom.random_number returns an integer:
+  # 0 <= SecureRandom.random_number(n) < n.
+  #
+  # If 0 is given or an argument is not given,
+  # SecureRandom.random_number returns an float:
+  # 0.0 <= SecureRandom.random_number() < 1.0.
+  def self.random_number(n=0)
+    if 0 < n
+      hex = n.to_s(16)
+      hex = '0' + hex if (hex.length & 1) == 1
+      bin = [hex].pack("H*")
+      mask = bin[0].ord
+      mask |= mask >> 1
+      mask |= mask >> 2
+      mask |= mask >> 4
+      begin
+        rnd = SecureRandom.random_bytes(bin.length)
+        rnd[0] = (rnd[0].ord & mask).chr
+      end until rnd < bin
+      rnd.unpack("H*")[0].hex
+    else
+      # assumption: Float::MANT_DIG <= 64
+      i64 = SecureRandom.random_bytes(8).unpack("Q")[0]
+      Math.ldexp(i64 >> (64-Float::MANT_DIG), -Float::MANT_DIG)
+    end
+  end
+
+end
+
+# Added by joelparkerhenderson@gmail.com for backwards compatibility with Ruby 1.8
+class Fixnum
+ def ord
+  return self
+ end
+end

data/test/webget_ruby_secure_random_test.rb

@@ -0,0 +1,48 @@
+require 'test/unit'
+require 'webget_ruby_secure_random'
+
+class Testing < Test::Unit::TestCase
+
+ def test_random_bytes
+  n=16
+  20.times{
+   x=SecureRandom.random_bytes(16)
+   assert_equal(x.length,n)
+  }
+ end
+
+ def test_hex
+  n=16
+  20.times{
+   x=SecureRandom.hex(n)
+   assert_equal(x.length,2*n)
+  }
+ end
+
+ def test_base64
+  n=16
+  20.times{
+   x=SecureRandom.base64(n)
+   assert(x.length>=n,"x length #{x.length} >= n #{n}")
+   assert(x.length<2*n,"x length #{x.length} < 2n #{2*n}")
+  }
+ end
+
+ def test_random_number_integer
+  n=16
+  20.times{
+   x=SecureRandom.random_number(n)
+   assert(0<=x,"0<=x")
+   assert(x<n,"x<n")
+  }
+ end
+
+ def test_random_number_float
+  20.times{
+   x=SecureRandom.random_number
+   assert(0<=x,"0<=x")
+   assert(x<1,"x<1")
+  }
+ end
+
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: webget_ruby_secure_random
+version: !ruby/object:Gem::Version 
+  version: 1.2.0
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDvDCCAyWgAwIBAgIJAIlSqEkDQaZIMA0GCSqGSIb3DQEBBQUAMIGbMQswCQYD
+  VQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5j
+  aXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UECxMKV2ViR2V0LmNvbTET
+  MBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJARYRd2ViZ2V0QHdlYmdl
+  dC5jb20wHhcNMDkwMjI2MTk0NDU4WhcNMTExMTIzMTk0NDU4WjCBmzELMAkGA1UE
+  BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+  Y28xEzARBgNVBAoTCldlYkdldC5jb20xEzARBgNVBAsTCldlYkdldC5jb20xEzAR
+  BgNVBAMTCldlYkdldC5jb20xIDAeBgkqhkiG9w0BCQEWEXdlYmdldEB3ZWJnZXQu
+  Y29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDXCFYfW6hCQl0ToNjaMIXG
+  ZfPF6OoR20BO/Tg6V37qPi7gDSZ6vIC6Mxcs8LtEcju85cD9lnKKl/lo4S5/w9Ha
+  hGD2ZFFfbF8420X5Za5G2KuriS3GzRz7F5dKCTjb1NH9TPlgOc71bcrDmCwwtFJl
+  T+tdfBju0YxLSBiMXf4y5QIDAQABo4IBBDCCAQAwHQYDVR0OBBYEFHB1kXO/Xd4g
+  G+AJ2/wwh6JOWXzNMIHQBgNVHSMEgcgwgcWAFHB1kXO/Xd4gG+AJ2/wwh6JOWXzN
+  oYGhpIGeMIGbMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQG
+  A1UEBxMNU2FuIEZyYW5jaXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UE
+  CxMKV2ViR2V0LmNvbTETMBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJ
+  ARYRd2ViZ2V0QHdlYmdldC5jb22CCQCJUqhJA0GmSDAMBgNVHRMEBTADAQH/MA0G
+  CSqGSIb3DQEBBQUAA4GBADzVXlwuff0/w3yK4LflGKKhtC3oChIrwmSyP6tk628N
+  BHokpc4Kz63xSXqzYTnBS7rFBwlYThtNalQeWmoUjGh3Z0ZR0JlhU0ln8899LuJ3
+  DXnLFY0cVuBnNDMOOFl8vk1qIcZjcTovhzgcixpG6Uk5qmUsKHRLQf4oQJx7TfLK
+  -----END CERTIFICATE-----
+
+date: 2010-02-17 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/webget_ruby_secure_random.rb
+has_rdoc: true
+homepage: http://webget.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WebGet Ruby Gem: secure random number method for Ruby 1.8.6"
+test_files: 
+- test/webget_ruby_secure_random_test.rb