alphadecimal 1.0.1

data/History.txt

@@ -0,0 +1,10 @@
+### 1.0.0 / 2008-03-11
+
+* added rails/init.rb to allow loading as a gem into a Rails app
+
+### 1.0.0 / 2008-03-11
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/alphadecimal
+init.rb
+lib/alphadecimal.rb
+test/test_alphadecimal.rb

data/README.txt

@@ -0,0 +1,49 @@
+= alphadecimal
+
+* http://github.com/JackDanger/alphadecimal
+
+== DESCRIPTION:
+
+Convert integers to base62 strings (A-Za-z0-9) and back.  A handy
+way to shorten long numbers.
+
+== SYNOPSIS:
+
+  # 45.alphadecimal
+  # => 'j'
+  # 5234233.alphadecimal
+  # 'Lxf7'
+  # 'yH783Xx3Ajz99'.alphadecimal
+  # => 194466611442340388130115
+  # 194466611442340388130115.alphadecimal
+  # => 'yH783Xx3Ajz99'
+
+
+== INSTALL:
+
+* sudo gem install alphadecimal
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Jack Danger Canty, Mike Mondragon
+
+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,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/alphadecimal.rb'
+
+Hoe.new('alphadecimal', Alphadecimal::VERSION) do |p|
+  # p.rubyforge_name = 'alphadecimal' # if different than lowercase project name
+  p.developer('Mike Mondragon', 'mikemondragon@gmail.com')
+  p.developer('Jack Danger Canty', 'jdanger@adpickles.com')
+end
+
+# vim: syntax=Ruby

data/init.rb

@@ -0,0 +1 @@
+require 'alphadecimal'

data/lib/alphadecimal.rb

@@ -0,0 +1,64 @@
+module Alphadecimal
+  VERSION = '1.0.1'
+  
+  B62_0, B62_9 = '0'[0], '9'[0]
+  B62_A, B62_Z = 'A'[0], 'Z'[0]
+  B62_a, B62_z = 'a'[0], 'z'[0]
+  B62_CHRS = [(B62_0..B62_9).map, (B62_A..B62_Z).map,  (B62_a..B62_z).map].flatten
+
+  module Number
+    def alphadecimal
+      return self if nil? || self < 0
+      return to_s if self == 0
+      string = ""
+      value = self
+      until value == 0
+        case mod = value % 62
+        when 0..9 then string << (mod + B62_0)
+        when 10..35 then string << (mod - 10 + B62_A)
+        when 36...62 then string << (mod - 36 + B62_a)
+        end
+        value = value / 62
+      end
+      string.reverse
+    end
+  end
+  
+  module String
+    def alphadecimal
+      return self unless is_alphadecimal?
+      val = 0
+      key = reverse
+      (0...key.size).each do |i|
+         char = key[i]
+         case
+         when (B62_0..B62_9).include?(char) then norm = char - B62_0
+         when (B62_A..B62_Z).include?(char) then norm = char - B62_A + 10
+         when (B62_a..B62_z).include?(char) then norm = char - B62_a + 36
+         end
+        val = val + (norm * (62 ** i))
+      end
+      val
+    end
+    
+    def is_alphadecimal?
+      return false if nil?
+      string = self.dup
+      return false if string.length <= 0
+      (0...string.size).each do |i|
+        return false unless B62_CHRS.include?(string[i])
+      end
+      true
+    end
+  end
+end
+
+class String
+  include Alphadecimal::String
+end
+class Fixnum
+  include Alphadecimal::Number
+end
+class Bignum
+  include Alphadecimal::Number
+end

data/test/test_alphadecimal.rb

@@ -0,0 +1,69 @@
+require 'test/unit'
+require File.dirname(__FILE__) + "/../lib/alphadecimal"
+
+class TestAlphadecimal < Test::Unit::TestCase
+
+  include Alphadecimal
+  
+  def test_fixnum_becomes_string
+    assert_kind_of String, 45.alphadecimal
+  end
+  
+  def test_bignum_becomes_string
+    assert_kind_of String, 231087934571049032.alphadecimal
+  end
+  
+  def test_string_becomes_bignum
+    assert_kind_of Bignum, 'aHealk43JZy'.alphadecimal
+  end
+  
+  def test_string_becomes_fixnum
+    assert_kind_of Fixnum, 'j'.alphadecimal
+  end
+  
+  def test_invalid_string_returns_self
+    string = 'Whoah there!'
+    assert_equal string, string.alphadecimal
+  end
+  
+  def test_identities
+    [123, 90000008, 733, '12331', 'abYzj', '0', 'A', 'z',
+     79823898923232, 'ZZZZZZZZZZZZZZZZZZZ', 'Yz82J3Ng5Nj9M1',
+     '!!!', '@$%!^', 'abc ', 'HP', 4, 'ǟ'].each do |object|
+      assert_equal object, object.alphadecimal.alphadecimal
+    end
+  end
+
+  def test_alphabet_characters_should_only_validate
+    alphabet = (('0'[0]..'9'[0]).collect << 
+                ('A'[0]..'Z'[0]).collect << 
+                ('a'[0]..'z'[0]).collect).flatten
+    (0..255).each do |i|
+      case
+        when alphabet.include?(i)
+           assert i.chr.is_alphadecimal?, "char #{i} is not valid as string #{i.chr}"
+        else
+           assert !i.chr.is_alphadecimal?, "char #{i} is valid as string #{i.chr}"
+      end
+    end 
+  end
+
+  def test_edge_62_to_the_0_convertions_should_be_valid
+    (0...62).each do |i|
+      encode = i.alphadecimal
+      decode = encode.alphadecimal
+      assert_equal i, decode, "integer #{i} was encoded as #{encode} and was decoded to #{decode}"
+    end
+  end
+
+  def test_edge_62_to_the_n_convertions_should_be_valid
+    (0...3).each do |p|
+      n = 62 ** p
+      (0...62).each do |i|
+        encode = (i+n).alphadecimal
+        decode = encode.alphadecimal
+        assert_equal i+n, decode, "interger #{i+n} was encoded as #{encode} and was decoded to #{decode}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: alphadecimal
+version: !ruby/object:Gem::Version 
+  version: 1.0.1
+platform: ruby
+authors: 
+- Mike Mondragon
+- Jack Danger Canty
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-03-27 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.1
+    version: 
+description: Convert integers to base62 strings (A-Za-z0-9) and back.  A handy way to shorten long numbers.
+email: 
+- mikemondragon@gmail.com
+- jdanger@adpickles.com
+executables: 
+- alphadecimal
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/alphadecimal
+- init.rb
+- lib/alphadecimal.rb
+- test/test_alphadecimal.rb
+has_rdoc: true
+homepage: http://github.com/JackDanger/alphadecimal
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: alphadecimal
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Convert integers to base62 strings (A-Za-z0-9) and back
+test_files: 
+- test/test_alphadecimal.rb