rand62 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Kenn Ejima
+
+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,49 @@
+# Rand62
+
+Generates random alphanumeric characters.
+
+```ruby
+Rand62.safe(10)
+ => "yTX35RzROS"
+```
+
+It has better space efficiency than `SecureRandom.uuid` or `SecureRandom.hex`. It's sexier than `SecureRandom.base64` or `SecureRandom.urlsafe_base64` as Rand62 doesn't contain any symbols.
+
+If you care more about database efficiency than Ruby, and user-friendliness of the look of IDs, use Rand62.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rand62'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rand62
+
+## Usage
+
+There are two methods: `fast` and `safe`.
+
+* **safe** - It has less chance of collision, as internally it uses `SecureRandom`. Use this method until the performance of this method becomes a problem.
+* **fast** - About 10x faster than `safe` on Mac, but be careful as internally it uses rand().
+
+```ruby
+Rand62.fast(10)
+ => "sWCGqxY2kF"
+
+Rand62.safe(10)
+ => "yTX35RzROS"
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+    t.libs << "test"
+    t.test_files = FileList['test/test*.rb']
+    t.verbose = false
+  end
+
+task :default => :test

data/lib/rand62.rb

@@ -0,0 +1,16 @@
+require 'rand62/version'
+require 'securerandom'
+
+class Rand62
+  CHARS = ('0'..'9').to_a + ('A'..'Z').to_a + ('a'..'z').to_a
+
+  class << self
+    def safe(n)
+      n.times.map{ CHARS[SecureRandom.random_number(62)] }.join
+    end
+
+    def fast(n)
+      n.times.map{ CHARS.sample(1) }.join
+    end
+  end
+end

data/lib/rand62/core_ext.rb

@@ -0,0 +1,29 @@
+require 'rand62'
+
+class String
+  BASE62_MAP = Hash[Rand62::CHARS.map.with_index{|c,i| [c, i] }]
+
+  def base62
+    i = 0
+    i_out = 0
+    self.split(//).reverse.each do |c|
+      place = 62 ** i
+      i_out += BASE62_MAP[c] * place
+      i += 1
+    end
+    i_out
+  end
+end
+
+class Integer
+  def base62
+    return '0' if (i = self) == 0
+    s = ''
+    while i > 0
+      s << Rand62::CHARS[i.modulo(62)]
+      i /= 62
+    end
+    s.reverse!
+    s
+  end
+end

data/lib/rand62/version.rb

@@ -0,0 +1,3 @@
+class Rand62
+  VERSION = "0.0.1"
+end

data/rand62.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rand62/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Kenn Ejima"]
+  gem.email         = ["kenn.ejima@gmail.com"]
+  gem.description   = %q{Generates random alphanumeric characters}
+  gem.summary       = %q{Generates random alphanumeric characters}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "rand62"
+  gem.require_paths = ["lib"]
+  gem.version       = Rand62::VERSION
+end

data/test/test_rand62.rb

@@ -0,0 +1,47 @@
+require 'rand62/core_ext'
+require 'test/unit'
+require 'set'
+
+class TestRand62 < Test::Unit::TestCase
+  def measure
+    start = Time.now
+    yield
+    Time.now - start
+  end
+
+  def test_rand62
+    assert_match Rand62.safe(1000), /^[0-9a-zA-Z]+$/
+    assert_match Rand62.fast(1000), /^[0-9a-zA-Z]+$/
+  end
+
+  def test_distribution
+    set = Set.new
+    rand62 = Rand62.safe(1000)
+
+    rand62.split(//).each do |char|
+      set.add(char)
+    end
+
+    assert_equal 1000, rand62.size
+    assert_equal 62, set.size
+  end
+
+  def test_core_ext
+    assert_equal 1000000000.base62, '15ftgG'
+    assert_equal '15ftgG'.base62, 1000000000
+
+    assert_equal '123abcABC'.base62, 225587272106046
+    assert_equal 225587272106046.base62, '123abcABC'
+  end
+
+  def test_benchmark
+    n = 1000
+
+    fast = measure { Rand62.fast(n) }
+    safe = measure { Rand62.safe(n) }
+
+    puts "Rand62.fast(#{n}): #{fast}"
+    puts "Rand62.safe(#{n}): #{safe}"
+    assert fast < safe
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: rand62
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kenn Ejima
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-05 00:00:00.000000000 Z
+dependencies: []
+description: Generates random alphanumeric characters
+email:
+- kenn.ejima@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rand62.rb
+- lib/rand62/core_ext.rb
+- lib/rand62/version.rb
+- rand62.gemspec
+- test/test_rand62.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+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: 
+rubygems_version: 1.8.19
+signing_key: 
+specification_version: 3
+summary: Generates random alphanumeric characters
+test_files:
+- test/test_rand62.rb
+has_rdoc: