randint 0.0.2

data/.autotest

@@ -0,0 +1,25 @@
+# -*- ruby -*-
+
+require "autotest/restart"
+
+# Autotest.add_hook :initialize do |at|
+#   at.testlib = "minitest/unit"
+#
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception "vendor"
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.md

@@ -0,0 +1,4 @@
+=== 0.0.1 / 2014-02-14
+
+* 1 major enhancement
+* Birthday!

data/Manifest.txt

@@ -0,0 +1,10 @@
+.autotest
+History.md
+Manifest.txt
+README.md
+Rakefile
+bin/randint
+lib/randint.rb
+lib/randint/error.rb
+randint.gemspec
+test/test_randint.rb

data/README.md

@@ -0,0 +1,52 @@
+# Randint
+
+* https://github.com/awesome/randint
+
+## DESCRIPTION:
+
+Creates positive integer with specified number of digits (i.e., specified "length" when coverted to string)
+
+## FEATURES:
+
+* Specify random number generator: Kernel (default), Random or SecureRandom
+* Kernel#rand and Random#rand are essentially the same and both included for ocd
+
+## REQUIREMENTS:
+
+*  Ruby >= 1.9.3
+
+## INSTALL:
+
+    $ gem install 'randint'
+
+## USAGE:
+
+    Randint.create(3)
+    #=> 111
+    Randint.create(50, SecureRandom)
+    #=> 45777499250739151797487680834117802518338464049274
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2014 SoAwesomeMan
+
+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,22 @@
+# -*- ruby -*-
+
+require "rubygems"
+require "hoe"
+
+Hoe.plugin :clean
+Hoe.plugin :yard
+Hoe.plugin :gemspec
+
+Hoe.spec "randint" do
+  developer("SoAwesomeMan", "callme@1800AWESO.ME")
+
+  self.yard_title = 'Randint (0.0.2)'
+  self.yard_markup = 'markdown'
+  self.yard_opts = []
+
+  clean_globs << '.yardoc'
+
+  license "MIT"
+end
+
+# vim: syntax=ruby

data/bin/randint

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+abort "you need to write me"

data/lib/randint.rb

@@ -0,0 +1,90 @@
+require "securerandom"
+require "randint/error"
+
+module Randint
+  VERSION = "0.0.2"
+
+  extend self
+
+  # Creates positive integer with specified number of digits (i.e., specified "length" when coverted to string)
+  #
+  # @param length [Integer]
+  # @param lib [Class,Module] the lib to generate component random numbers from, `Kernel` or `Random` or `SecureRandom`
+  # @return [Integer]
+  def create(length, lib=nil)
+    raise Randint::Error::InvalidArg unless length.is_a?(Integer) and length > 0
+    raise Randint::Error::InvalidLib if lib and ![::Kernel,::Random,::SecureRandom].include?(lib)
+    lib ||= Kernel
+    n = ''
+    n << rand_string(lib) until n.length >= length
+    n[0..length-1].to_i
+  end
+
+  # format lib's rand string
+  #
+  # @param lib [Class,Module]
+  # @return [String]
+  def rand_string(lib)
+    x = send("#{underscore(lib.to_s)}_rand")
+    format_left(x.to_s)
+  end
+
+  # converts CamelCase to underscore
+  #
+  # @author https://gist.github.com/timcharper/4027440
+  # @param string [String]
+  # @return [String]
+  def underscore(string)
+    string.gsub(/(.)([A-Z])/,'\1_\2').downcase
+  end
+
+  # remove leading zeros and decimal point from left of string
+  #
+  # @param string [String] Float#to_s
+  # @return [String]
+  def format_left(string)
+    string.gsub(/^[0\.]*/,'')
+  end
+
+  # Counts digits in fractional part of decimal number
+  #
+  # @author http://stackoverflow.com/a/8597808/1076207
+  # @param float [Float]
+  # @return [Integer]
+  def decimal_place_length(float)
+    num = 0
+    while(float != float.to_i)
+      num += 1
+      float *= 10
+    end
+    num
+  end
+
+  # Creates random number via SecureRandom#random_number
+  #
+  # @see http://rubydoc.info/stdlib/securerandom/1.9.3/SecureRandom.random_number
+  # @return [String]
+  def secure_random_rand
+    SecureRandom.random_number
+  end
+
+  # Creates random number via Random#rand
+  #
+  # @return [String]
+  # @see http://ruby-doc.org/core-1.9.3/Random.html#method-c-rand
+  def random_rand
+    Random.rand
+  end
+
+  # Creates random number via Kernel#rand
+  #
+  # @return [String]
+  # @see http://ruby-doc.org/core-1.9.3/Kernel.html#method-i-rand
+  #
+  # @notes
+  #   "The important difference to note is that if you just call rand() you are calling Kernel#rand, which only supports a max argument. If you want to pass a range, you have to use Random#rand, meaning you have to implement this way."
+  #   http://stackoverflow.com/questions/4395095/how-to-generate-a-random-number-between-a-and-b-in-ruby#comment19986191_13119700
+  def kernel_rand
+    Kernel.rand
+  end
+end

data/lib/randint/error.rb

@@ -0,0 +1,6 @@
+module Randint
+  module Error
+    class InvalidArg < StandardError; end
+    class InvalidLib < StandardError; end
+  end
+end

data/randint.gemspec

@@ -0,0 +1,38 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "randint"
+  s.version = "0.0.2.20140218094847"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["SoAwesomeMan"]
+  s.date = "2014-02-18"
+  s.description = "Creates positive integer with specified number of digits (i.e., specified \"length\" when coverted to string)"
+  s.email = ["callme@1800AWESO.ME"]
+  s.executables = ["randint"]
+  s.extra_rdoc_files = ["History.md", "Manifest.txt", "README.md", "History.md"]
+  s.files = [".autotest", "History.md", "Manifest.txt", "README.md", "Rakefile", "bin/randint", "lib/randint.rb", "lib/randint/error.rb", "randint.gemspec", "test/test_randint.rb", ".gemtest"]
+  s.homepage = "https://github.com/awesome/randint"
+  s.licenses = ["MIT"]
+  s.rdoc_options = ["--title", "Randint (0.0.2)", "--markup", "markdown", "--quiet"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "randint"
+  s.rubygems_version = "1.8.23"
+  s.summary = "Creates positive integer with specified number of digits (i.e., specified \"length\" when coverted to string)"
+  s.test_files = ["test/test_randint.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<hoe-yard>, [">= 0.1.2"])
+      s.add_development_dependency(%q<hoe>, ["~> 3.9"])
+    else
+      s.add_dependency(%q<hoe-yard>, [">= 0.1.2"])
+      s.add_dependency(%q<hoe>, ["~> 3.9"])
+    end
+  else
+    s.add_dependency(%q<hoe-yard>, [">= 0.1.2"])
+    s.add_dependency(%q<hoe>, ["~> 3.9"])
+  end
+end

data/test/test_randint.rb

@@ -0,0 +1,43 @@
+require "minitest/autorun"
+require "randint"
+
+class TestRandint < MiniTest::Unit::TestCase
+  def setup
+    @libs = [nil,Kernel,Random,SecureRandom]
+  end
+
+  def test_create_double_digets
+    @libs.each do |lib|
+      length = rand(10..100)
+      act = Randint.create(length, lib)
+      assert_kind_of Integer, act
+      assert_equal(length, act.to_s.length)
+    end
+  end
+
+  def test_create_single_digit
+    @libs.each do |lib|
+      length = rand(1..9)
+      act = Randint.create(length, lib)
+      assert_kind_of Integer, act
+      assert_equal(length, act.to_s.length)
+    end
+  end
+
+  def test_int_zero
+    @libs.each do |lib|
+      assert_raises(Randint::Error::InvalidArg) {Randint.create(0, lib)}
+    end
+  end
+
+  def test_format_left
+    exp = rand(1..1000).to_s
+    #array = ("." * rand(1..3)) + ("0" * rand(1..3)).chars.to_a.permutation.map {|x| x.join + exp.to_s}
+    arr = "#{"." * rand(1..3)}#{"0" * rand(1..3)}".chars.to_a.permutation.map(&:join).map {|x| "#{x}#{exp}"}
+    arr.each do |x|
+      act = Randint.format_left(x)
+      assert_instance_of String, act
+      assert_equal exp, act
+    end
+  end
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: randint
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- SoAwesomeMan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hoe-yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.9'
+description: Creates positive integer with specified number of digits (i.e., specified
+  "length" when coverted to string)
+email:
+- callme@1800AWESO.ME
+executables:
+- randint
+extensions: []
+extra_rdoc_files:
+- History.md
+- Manifest.txt
+- README.md
+files:
+- .autotest
+- History.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/randint
+- lib/randint.rb
+- lib/randint/error.rb
+- randint.gemspec
+- test/test_randint.rb
+- .gemtest
+homepage: https://github.com/awesome/randint
+licenses:
+- MIT
+post_install_message: 
+rdoc_options:
+- --title
+- Randint (0.0.2)
+- --markup
+- markdown
+- --quiet
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: randint
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Creates positive integer with specified number of digits (i.e., specified
+  "length" when coverted to string)
+test_files:
+- test/test_randint.rb