randy 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.rvmrc
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,8 @@
+source :rubygems
+
+# Specify your gem's dependencies in randy.gemspec
+gemspec
+
+group :test do
+  gem "rspec"
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Dan Tao
+
+MIT License
+
+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/README.md

@@ -0,0 +1,54 @@
+# Randy
+
+A little library for easily producing random data using Ruby's built-in `rand` function.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'randy'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install randy
+
+## Usage
+
+Currently **randy** can produce two kinds of random data (in theory this will change).
+
+### Strings
+
+The original main purpose of this library is to produce random strings easily.
+
+For example, to produce a random 10-character string:
+
+    # Example output: BASWCEV3TQ
+    Randy.string(10)
+
+By default, the result string will comprise characters from the digits 0-9 and the English alphabet.
+
+This can be changed by specifying the characters to be used:
+    
+    # Example output: baaabbabac
+    Randy.string(10, "abc")
+
+### Numbers
+
+It's already easy to produce random numbers using Ruby. However, **randy** makes it *even easier*.
+
+To produce a random *integer*, just specify a range:
+
+    # Will include some number between 1 and 10
+    Randy.integer(1..10)
+
+The result will be consistent with how Ruby ranges work; that is, an inclusive range (`..`) will potentially include the upper bound while an exclusive range (`...`) will not.
+
+Admittedly, the above is quite trivial to implement by hand, e.g., with `1 + rand(10)`. Think of it simply as a nicer interface to `rand`.
+
+The same functionality is also exposed to decimal values:
+
+    Randy.decimal((1.4)..(6.2))

data/Rakefile

@@ -0,0 +1,5 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)

data/lib/randy.rb

@@ -0,0 +1,17 @@
+module Randy
+  DEFAULT_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ".split("").freeze
+
+  def self.string(length, chars=DEFAULT_CHARS)
+    chars = chars.is_a?(String) ? chars.split("") : chars
+    (1..length).inject("") { |s, c| s << chars[rand(chars.count)] }
+  end
+
+  def self.integer(range)
+    return range.min if range.max == range.min
+    return range.min + rand(1 + range.max - range.min)
+  end
+
+  def self.decimal(range)
+    return range.begin + ((range.end - range.begin) * rand())
+  end
+end

data/lib/randy/version.rb

@@ -0,0 +1,3 @@
+module Randy
+  VERSION = "0.0.1"
+end

data/randy.gemspec

@@ -0,0 +1,16 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/randy/version", __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Dan Tao"]
+  gem.email         = ["daniel.tao@gmail.com"]
+  gem.description   = %q{Randy makes it that much easier to generate random stuff.}
+  gem.summary       = %q{A little library for easily producing random data using Ruby's built-in rand function.}
+  gem.homepage      = "http://dtao.github.com/randy/"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = gem.files.grep(%r{^spec/})
+  gem.name          = "randy"
+  gem.require_paths = ["lib"]
+  gem.version       = Randy::VERSION
+end

data/spec/randy_spec.rb

@@ -0,0 +1,47 @@
+require File.join(File.dirname(__FILE__), "spec_helper")
+
+require "randy"
+
+describe Randy do
+  describe "::string" do
+    it "produces a string of the given length" do
+      Randy.string(5).length.should == 5
+    end
+
+    it "produces an empty string given a length of zero" do
+      Randy.string(0).length.should == 0
+    end
+
+    it "produces an empty string given a negative length" do
+      Randy.string(-1).length.should == 0
+    end
+
+    it "includes only the specified characters in the result string" do
+      Randy.string(100, ["a", "b", "c"]).should =~ /^[abc]{100}$/
+    end
+
+    it "will also accept a set of characters as a string" do
+      Randy.string(100, "abc").should =~ /^[abc]{100}$/
+    end
+  end
+
+  describe "::integer" do
+    it "produces the only possible value for a range of size 1" do
+      Randy.integer(42..42).should == 42
+    end
+
+    it "produces a value within the given range" do
+      1000.times do
+        (1..10).should include(Randy.integer(1..10))
+      end
+    end
+
+    it "might potentially produce the max of an inclusive range" do
+      1000.times.map { Randy.integer(1..5) }.should include(5)
+    end
+
+    it "will not produce the max of an exclusive range" do
+      1000.times.map { Randy.integer(1...5) }.should_not include(5)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require "rspec"
+
+$LOAD_PATH << File.join(File.dirname(__FILE__), "..", "lib")

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: randy
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Dan Tao
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-04 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Randy makes it that much easier to generate random stuff.
+email: 
+- daniel.tao@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/randy.rb
+- lib/randy/version.rb
+- randy.gemspec
+- spec/randy_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://dtao.github.com/randy/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: A little library for easily producing random data using Ruby's built-in rand function.
+test_files: 
+- spec/randy_spec.rb
+- spec/spec_helper.rb