pixiedust 0.0.3

data/History.txt

@@ -0,0 +1,7 @@
+== 0.0.3 / 2008-02-27
+
+* Initial release
+  * RandomDust.between
+  * NumberDust.nearest
+  * DateDust.now_str
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/pixiedust.rb
+test/number_dust.rb
+test/random_dust.rb

data/README.txt

@@ -0,0 +1,51 @@
+PixieDust
+    by Jonathan Wilkins
+    http://pixiedust.rubyforge.org
+
+== DESCRIPTION:
+A collection of little utility functions (many security related) for assorted
+random tasks in Ruby
+
+Where applicable, they come with a standard version and a class mix in.
+Ex:
+NumberDust.nearest(value) is also available as Integer.pd_nearest
+
+== FEATURES/PROBLEMS:
+* Get random numbers in arbitrary ranges from OpenSSL (without skew due 
+  to modulo)
+
+== SYNOPSIS:
+require 'pixiedust'
+x = RandomDust.between(10,20)
+
+== REQUIREMENTS:
+None yet.
+
+== INSTALL:
+
+* sudo gem install pixiedust
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,17 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/pixiedust.rb'
+
+Hoe.new('pixiedust', PixieDust::VERSION) do |p|
+  p.rubyforge_name = 'pixiedust'
+  p.author = 'Jonathan Wilkins'
+  p.email = 'jwilkins[at]bitland[dot]net'
+  p.summary = 'A collection of little routines and functions'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+end
+
+# vim: syntax=Ruby

data/lib/pixiedust.rb

@@ -0,0 +1,77 @@
+begin
+  require 'openssl'
+rescue LoadError
+  require 'OpenSSL' # OS X
+end
+
+class PixieDust
+  VERSION = '0.0.3'
+end
+
+class PDRandOutOfRange < RangeError; end
+
+class RandomDust
+  # XXX: Do something to make sure that OpenSSL is using a real RNG
+  def between(min, max)
+    RandomDust.between(min, max)
+  end
+
+  def RandomDust.between(min, max)
+    if min > max then raise "min > max in RandomDust.between"; end
+
+    value = 0
+    range = max - min
+    bytes_used = range.size
+    uints = range.size/4
+
+    delta = 2**(8*range.size) - range
+
+    if    delta >  16777216                  then bytes_used -= 3; unp="C"
+    elsif delta >= 65536 && delta < 16777216 then bytes_used -= 2; unp="S"
+    elsif delta >= 256   && range < 65536    then bytes_used -= 1; unp="SC"
+    else                                                           unp=""
+    end
+
+    begin
+      rand = OpenSSL::Random.random_bytes(bytes_used)
+      parts = rand.unpack(unp + "L"*(uints))
+      value = parts.shift
+      parts.length.upto(uints - 1){ |x|
+        value += parts[x] << 32*x
+      }
+
+      value += min
+
+      if value < min || value > max then raise PDRandOutOfRange; end
+    rescue PDRandOutOfRange
+      retry
+    end
+    value
+  end
+end
+
+class DateDust
+  def DateDust.now_str
+    str = sprintf("%d%02d%02d%02d%02d%02d", Time.now.year, Time.now.month,
+                  Time.now.day, Time.now.hour, Time.now.min, Time.now.sec)
+  end
+end
+
+class NumberDust
+  def NumberDust.nearest(val)
+    factor = val.abs.to_s.length - 2
+    case factor
+    when -1..2
+      return val
+    else
+      mult = (10 ** factor)
+      return mult * (val/ mult)
+    end
+  end
+end
+
+class Integer
+  def pd_nearest
+    NumberDust.nearest(self)
+  end
+end

data/test/number_dust.rb

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'spec'
+
+require "#{File.dirname(__FILE__)}/../lib/pixiedust"
+
+describe NumberDust do
+  it "Shouldn't round small numbers" do
+    val = NumberDust.nearest(0)
+    val.should == 0
+    val = NumberDust.nearest(9)
+    val.should == 9
+    val = NumberDust.nearest(1005)
+    val.should == 1005
+  end
+
+  it "Should round big numbers" do
+    val = NumberDust.nearest(10005)
+    val.should == 10000
+    val = NumberDust.nearest(10805)
+    val.should == 10000
+    val = NumberDust.nearest(11805)
+    val.should == 11000
+    val = NumberDust.nearest(1181805)
+    val.should == 1100000
+  end
+end

data/test/random_dust.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'spec'
+
+require "#{File.dirname(__FILE__)}/../pixiedust"
+
+describe RandomDust do
+  it "Shouldn't generate numbers outside of range" do
+    min = -5
+    max = 15
+    100.times {
+      val = RandomDust.between(min,max)
+      val.should <= max
+      val.should >= min
+    }
+  end
+
+  it "Should generate numbers at ends of range" do
+    min = -5
+    max = 5
+    hit_min = false
+    hit_max = false
+    100.times {
+      if RandomDust.between(min, max) == min; then hit_min = true; end
+      if RandomDust.between(min, max) == max; then hit_max = true; end
+    }
+    hit_min.should == true
+    hit_max.should == true
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: pixiedust
+version: !ruby/object:Gem::Version 
+  version: 0.0.3
+date: 2008-02-27 00:00:00 -08:00
+summary: A collection of little routines and functions
+require_paths: 
+- lib
+email: jwilkins[at]bitland[dot]net
+homepage: "    by Jonathan Wilkins"
+rubyforge_project: pixiedust
+description: "Where applicable, they come with a standard version and a class mix in. Ex: NumberDust.nearest(value) is also available as Integer.pd_nearest  == FEATURES/PROBLEMS: * Get random numbers in arbitrary ranges from OpenSSL (without skew due  to modulo)  == SYNOPSIS: require 'pixiedust' x = RandomDust.between(10,20)  == REQUIREMENTS: None yet."
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Jonathan Wilkins
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/pixiedust.rb
+- test/number_dust.rb
+- test/random_dust.rb
+test_files: []
+
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: