base_convert 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dbccf02603e1f029d1acfa79abfff94b93f315c6
+  data.tar.gz: 44227572331e4c2203d3012f32377ea4bde2e573
+SHA512:
+  metadata.gz: 07e12a56d9fd457e70417ab65124d4b9fba0c45ecd922ec6ebdf8ec3856da9d10be56f69d11cf364dd3e9aeb4a57d150824cda3d5383df874115af2d4400b4ac
+  data.tar.gz: 89dd3ea459891e0bc478b1f808e680e1b6d761c4b4bfd4e7e7e0e6440f889139de4383e503510fd23ba817eee6bbe7cf42abddf753cf270278773a099fc4fad8

data/README.txt

@@ -0,0 +1,84 @@
+# BaseConvert
+# DESCRIPTION:
+# Got the code originally from
+#	http://rosettacode.org/wiki/Non-decimal_radices/Convert#Ruby
+# which I then converted to a class.
+# SINOPSIS:
+
+def ok(a,b)
+  raise "bad! /#{a}/ == /#{b}/" unless a == b
+end
+
+# ruby -I ./lib README.txt
+if RUBY_VERSION =~ /^1.9.2/ then
+  require 'base_convert'
+
+  # Verify it works up to base 36 with number.to_s(n)
+  2.upto(36) do |n|
+    base = BaseConvert.new(n)
+    100.times do
+      number = rand(10000)
+      string = number.to_s(n)
+      ok( base.convert(string), number  )
+      ok( base.convert(number), string.upcase  ) # BaseConvert uses caps
+    end
+  end
+
+  # BaseConvert is case insensitive up to base 36, but
+  # returns string values with capital leters.  
+  # At base 37 and up, it's case sensitive with lower case letter being of higher order.
+  # It primary use is to reduce digest strings.
+  # For example:
+  require 'digest'
+  # This hexadecimal:
+  ok(	"7f83b1657ff1fc53b92dc18148a1d65dfc2d4b1fa3d677284addd200126d9069",
+	hexdigest = Digest::SHA256.hexdigest('Hello World!') )
+  # Translatates to this word(\w except '_') string
+  ok(	string = 'UEjKBW7lvEq1KjyCxAYQRJqmvffQEbwLNvzs8Ggdy4P',
+	BaseConvert.new(:hexadecimal,:word).convert(hexdigest) )
+  # and we can covert it back:
+  ok(	BaseConvert.new(:word,:hexadecimal).convert(string),
+	hexdigest.upcase )
+  # Again, note the BaseConvert returns the hexdigest string capitalized.
+  #There is also a quotable string([[:graph:]] except [`'"]):
+  ok(	qstring = '$<c6PCX_mugC58xfO5JOp+V4|<jHekI^_WE$?d?9',
+	BaseConvert.new(:hexadecimal,:qgraph).convert(hexdigest))
+  # And you can convert it back
+  ok(	BaseConvert.new(:qgraph,:hexadecimal).convert(qstring),
+	hexdigest.upcase)
+  # Note the length
+  ok(	64, hexdigest.length)
+  ok(	43, string.length)
+  ok(	40, qstring.length)
+
+  # BaseConvert has the following primary form:
+  #	# converting from basefrom to baseto
+  #	base = BaseConvert.new( basefrom, baseto )
+  #	# covert basefrom_string in basefrom to baseto_string in baseto
+  #	baseto_string = base.convert( basefrom_string )
+  #	# convert basefrom_string to it's decimal number representation
+  #	decimal_number = base.base2dec( basefrom_string )
+  #	# convert a decimal_number to it's baseto string representation
+  #	baseto_string = base.dec2base( decimal_number )
+  # BaseConvert has the following heuristic forms:
+  #	# converting to and from _base_
+  #	base = BaseConvert.new( _base_ )
+  #	base_string = base.convert( decimal_number )
+  #	decimal_number = base.convert( base_string )
+  # BaseConvert has the following mneumonic keys that can be use for base:
+  #	:binary	=> 2
+  #	:oct,:octal => 8,
+  #	:dec,:decimal => 10,
+  #	:hex,:hexadecimal => 16
+  # BaseConvert's base can go up to 62 with :word(\w except '_') and 91 with :qgraph([:graph] except [`'"].
+  # By default, :word is used...
+  ok(	'6laZE', BaseConvert.new(62).convert( 100_000_000 ))
+  # ...until a transition to :qgraph is required.
+  ok(	')8]3H', BaseConvert.new(63).convert( 100_000_000 ))
+  # But you can specify the digit dictionary. At this point you've read and know the code...
+  base = BaseConvert.new(62)
+  base.to_digits = BaseConvert::QGRAPH
+  ok(	')RGF1', base.convert( 100_000_000 ))
+end
+# The End.
+# <i>carlosjhr64</i>@<i>gmail<i/>.<i>com</i>

data/lib/base_convert.rb

@@ -0,0 +1,58 @@
+# http://rosettacode.org/wiki/Non-decimal_radices/Convert#Ruby
+class BaseConvert
+  DIGITS = 0.upto(255).map{|i| i.chr}.select{|c| c=~/\w/ && c=~/[^_]/} # 0..9 a..z A..Z
+  QGRAPH = 0.upto(255).map{|i| i.chr}.select{|c| c=~/[[:graph:]]/ && c=~/[^`'"]/}
+
+  BASE = {
+	:word		=> DIGITS.length,
+	:qgraph		=> QGRAPH.length,
+	:hexadecimal	=> 16,
+	:hex		=> 16,
+	:decimal	=> 10,
+	:dec		=> 10,
+	:octal		=> 8,
+	:oct		=> 8,
+	:binary		=> 2,
+  }
+
+  attr_accessor :from_digits, :to_digits
+  def initialize(basefrom,baseto=nil)
+    baseto = basefrom if baseto.nil?
+    @basefrom		= BASE[basefrom]	|| basefrom
+    @baseto		= BASE[baseto]		|| baseto
+    dl = DIGITS.length
+    @from_digits	= ((basefrom == :qgraph) || (@basefrom > dl))? QGRAPH : DIGITS
+    @to_digits		= ((baseto   == :qgraph) || (@baseto > dl))? QGRAPH : DIGITS
+  end
+
+  def convert(str)
+    if str.class == String
+      dec = base2dec(str)
+      return (@baseto == @basefrom)? dec : dec2base(dec)
+    end
+    dec2base(str)
+  end
+ 
+  def base2dec(str)
+    str = str.upcase if @basefrom < 37
+    raise ArgumentError, "base is invalid" unless @basefrom.between?(2, @from_digits.length)
+    res = 0
+    str.to_s.each_char do |c|
+      idx = @from_digits[0,@basefrom].find_index(c)
+      idx.nil? and raise ArgumentError, "invalid base-#{@basefrom} digit: #{c}"
+      res = res * @basefrom + idx
+    end
+    res
+  end
+ 
+  def dec2base(n)
+    return @to_digits.first if n == 0
+    raise ArgumentError, "base is invalid" unless @baseto.between?(2, @to_digits.length)
+    res = []
+    while n > 0
+      n, r = n.divmod(@baseto)
+      res.unshift(@to_digits[r])
+    end
+    res.join("") 
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: base_convert
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- carlosjhr64@gmail.com
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-12 00:00:00.000000000 Z
+dependencies: []
+description: Got the code originally from http://rosettacode.org/wiki/Non-decimal_radices/Convert#Ruby
+  which I then converted to a class.
+email: carlosjhr64@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- "./README.txt"
+- "./lib/base_convert.rb"
+homepage: https://github.com/carlosjhr64/base_convert
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: BaseConvert
+test_files: []