rencdec 0.0.1

data/README.rdoc

@@ -0,0 +1,31 @@
+= Rencdec
+Ruby encoder/decoder for arrays of arbitrary elements.
+
+== Purpose
+Created to fill a need in supplying two arrays (a,b) of varying size and representing a third array (c) that uses items from the first array (a) and reversably encodes it into items from the second array (b) and returns the fourth array (d). Decoding using the same arrays should turn fourth array (d) into the third array (c). Examples include letters to numbers, musical notes to colors, or any other grouping of objects describable as an array words.
+
+=== Example A
+Simple letters to numbers.
+  data =  'hello'.chars.map(&:to_sym)   #=> [:h, :e, :l, :l, :o]
+  current = abcdefghijklmnopqrstuvwxyz.chars.map(&:to_sym)   #=> [:a, :b, :c, :d, :e, :f, :g, :h, :i, :j, :k, :l, :m, :n, :o, :p, :q, :r, :s, :t, :u, :v, :w, :x, :y, :z]
+  target = (0..9).to_a   #=> [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+  rencdec = Rencdec.new(current_data: data, current_encoding: current, target_encoding: target)
+  rencdec.encode  #=> [3, 2, 7, 6, 8, 7, 2]
+  rencdec.decode  #=> [:h, :e, :l, :l, :o]
+  rencdec.verify  #=> true
+=== Example B
+Arbitrary letters to other letters.
+  rencdec = Rencdec.new(current_data: [:q,:w,:e,:r,:t,:y], current_encoding: [:e,:q,:r,:t,:w,:y], target_encoding: [:a,:b,:c,:d])
+  rencdec.encode  #=> [:d, :a, :c, :d, :d, :d, :d]
+  rencdec.decode  #=> [:q, :w, :e, :r, :t, :y]
+  rencdec.verify  #=> true
+=== Example C
+Musical notes to colors.
+  data = [:c,:d,:e,:f,:g,:a,:b,:c]
+  current = [:c,:cs,:d,:ds,:e,:f,:fs,:g,:gs,:a,:as,:b]
+  target = %w{red violet blue green yellow orange}.map(&:to_sym)  #=> [:red, :violet, :blue, :green, :yellow, :orange]
+  rencdec = Rencdec.new(current_data: data, current_encoding: current, target_encoding: target)
+  rencdec.encode  #=> [:yellow, :violet, :violet, :orange, :red, :blue, :green, :yellow, :red]
+  rencdec.decode  #=> [:c, :d, :e, :f, :g, :a, :b, :c]
+  rencdec.verify  #=> true
+= /Rencdec

data/lib/rencdec.rb

@@ -0,0 +1,24 @@
+require 'radix'
+
+class Rencdec
+	attr_reader :verbose, :current_encoding, :target_encoding, :current_data, :current_radix, :target_radix, :target_data
+	def initialize(params)
+		@current_encoding, @target_encoding, @current_data = params[:current_encoding], params[:target_encoding], params[:current_data]
+
+		@current_radix = Radix::Base.new current_encoding
+		@target_radix = Radix::Base.new target_encoding
+	end
+	def encode
+		tmp_current = current_data.map{|c| current_radix.values[c.to_s]}
+		tmp_target = Radix.convert_base(tmp_current, current_radix.base, target_radix.base)
+		@target_data ||= tmp_target.map{|t| tmp = target_radix.values.invert[t]; tmp[/^\d+$/] ? tmp.to_i : tmp.to_sym }
+	end
+	def decode
+		tmp_target = target_data.map{|t| target_radix.values[t.to_s]}
+		tmp_current = Radix.convert_base(tmp_target, target_radix.base, current_radix.base)
+		@current_data ||= tmp_current.map{|t| tmp = current_radix.values.invert[t]; tmp[/^\d+$/] ? tmp.to_i : tmp.to_sym }
+	end
+	def verify
+		encode == target_data && decode == current_data
+	end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: rencdec
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- klappy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: radix
+  requirement: &70232482048260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70232482048260
+description: Created to fill a need in supplying two arrays (a,b) of varying size
+  and representing a third array (c) that uses items from the first array (a) and
+  reversably encodes it into items from the second array (b) and returns the fourth
+  array (d). Decoding using the same arrays should turn fourth array (d) into the
+  third array (c). Examples include letters to numbers, musical notes to colors, or
+  any other grouping of objects describable as an array words.
+email: christopher@klapp.name
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/rencdec.rb
+- README.rdoc
+homepage: https://github.com/klappy/rencdec
+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.10
+signing_key: 
+specification_version: 3
+summary: Ruby encoder/decoder for arrays of arbitrary elements.
+test_files: []