hyperion-api 0.0.1.alpha1 → 0.0.1.alpha2

data/lib/hyperion/key.rb

@@ -0,0 +1,50 @@
+require 'base64'
+require 'uuidtools'
+
+module Hyperion
+  class Key
+    class << self
+
+      def encode_key(value)
+        normalize(Base64.encode64(value))
+      end
+
+      def decode_key(value)
+        Base64.decode64(denormalize(value))
+      end
+
+      def compose_key(kind, id=nil)
+        _id = id.nil? || id.to_s.strip == "" ? generate_id : id.to_s
+        encode_key("#{encode_key(kind.to_s)}:#{encode_key(_id)}")
+      end
+
+      def decompose_key(key)
+        decode_key(key).split(/:/).map {|part| decode_key(part)}
+      end
+
+      private
+
+      def generate_id
+        UUIDTools::UUID.random_create.to_s.gsub(/-/, '')
+      end
+
+      def normalize(value)
+        value.gsub(/=/, '').chomp
+      end
+
+      def denormalize(value)
+        case value.length % 4
+        when 3
+          "#{value}="
+        when 2
+          "#{value}=="
+        when 1
+          "#{value}==="
+        else
+          value
+        end
+      end
+
+    end
+  end
+end

data/spec/hyperion/key_spec.rb

@@ -0,0 +1,49 @@
+require 'hyperion/key'
+
+describe Hyperion::Key do
+
+  def encode_key(value)
+    Hyperion::Key.encode_key(value)
+  end
+
+  def decode_key(value)
+    Hyperion::Key.decode_key(value)
+  end
+
+  specify 'encoding' do
+    encode_key('a').should == 'YQ'
+    encode_key('ab').should == 'YWI'
+    encode_key('abc').should == 'YWJj'
+    encode_key('abcd').should == 'YWJjZA'
+    encode_key('abcde').should == 'YWJjZGU'
+    encode_key('abcdef').should == 'YWJjZGVm'
+  end
+
+  specify 'decoding' do
+    decode_key('YQ').should == 'a'
+    decode_key('YWI').should == 'ab'
+    decode_key('YWJj').should == 'abc'
+    decode_key('YWJjZA').should == 'abcd'
+    decode_key('YWJjZGU').should == 'abcde'
+    decode_key('YWJjZGVm').should == 'abcdef'
+  end
+
+  it 'composes unique keys' do
+    keys = (0...100).map {Hyperion::Key.compose_key('foo')}
+    Set.new(keys).length.should == 100
+    keys = (0...100).map {Hyperion::Key.compose_key(:foo)}
+    Set.new(keys).length.should == 100
+    Hyperion::Key.compose_key(:foo, 1).should == Hyperion::Key.compose_key(:foo, 1)
+  end
+
+  it 'decomposes keys' do
+    key = Hyperion::Key.compose_key(:thing, 1)
+    Hyperion::Key.decompose_key(key).should == ['thing', '1']
+  end
+
+  it 'decomposes keys with a :' do
+    key = Hyperion::Key.compose_key(:thing, 'my:key')
+    Hyperion::Key.decompose_key(key).should == ['thing', 'my:key']
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperion-api
 version: !ruby/object:Gem::Version
-  version: 0.0.1.alpha1
+  version: 0.0.1.alpha2
   prerelease: 6
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-14 00:00:00.000000000 Z
+date: 2012-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -27,6 +27,22 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 2.11.0
+- !ruby/object:Gem::Dependency
+  name: uuidtools
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.3
 description: A Generic Persistence API for Ruby
 email:
 - myles@8thlight.com
@@ -38,9 +54,11 @@ files:
 - lib/hyperion/dev/ds_spec.rb
 - lib/hyperion/filter.rb
 - lib/hyperion/api.rb
+- lib/hyperion/key.rb
 - lib/hyperion/sort.rb
 - lib/hyperion/query.rb
 - spec/hyperion/dev/memory_spec.rb
+- spec/hyperion/key_spec.rb
 - spec/hyperion/shared_examples.rb
 - spec/hyperion/api_spec.rb
 - spec/hyperion/fake_ds.rb
@@ -71,6 +89,7 @@ specification_version: 3
 summary: A Generic Persistence API for Ruby
 test_files:
 - spec/hyperion/dev/memory_spec.rb
+- spec/hyperion/key_spec.rb
 - spec/hyperion/shared_examples.rb
 - spec/hyperion/api_spec.rb
 - spec/hyperion/fake_ds.rb