ninjudd-tuple 0.0.2

data/README.rdoc

@@ -0,0 +1,32 @@
+= Tuple
+
+Tuple provides fast, binary-sortable serialization for arrays of simple Ruby types. This
+means you do not have to deserialize your tuples to store them. This leads to significant
+performance benifits when using Tuples as keys for a BTree.
+
+A Tuple is just an Array of any number of simple Ruby types. The following types are
+supported (listed in ascending sort order):
+  
+1. NilClass
+2. FalseClass
+3. Integer (Fixnum or Bignum)
+4. String
+5. Symbol
+6. True
+
+== Usage:
+   
+  require 'tuple'
+
+  data = Tuple.dump([1, -43, :foo, "bar", true, false, nil])
+  => "\000\000\020\000\000\000\000\001..."
+  Tuple.load(data)
+  => [1, -43, :foo, "bar", true, false, nil]
+
+== Install:
+
+  sudo gem install ninjudd-tuple -s http://gems.github.com
+
+== License:
+
+Copyright (c) 2009 Justin Balthrop, Geni.com; Published under The MIT License, see LICENSE

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:minor: 0
+:patch: 2
+:major: 0

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../ext')
+require 'tuple'
+
+class Test::Unit::TestCase
+end

data/test/tuple_test.rb

@@ -0,0 +1,61 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class TupleTest < Test::Unit::TestCase
+  should "dump and load arrays of simple types" do
+    t = [1, true, :foo, "foo", -1001, false, nil]
+    assert_equal t, Tuple.load(Tuple.dump(t))
+  end
+  
+  should "dump and load fixnums and bignums" do
+    t = [2**64, 2**32, 2**32 - 1, 2**31, 2**31 - 1, 1, 0]
+    t = t + t.collect {|n| -n}
+    assert_equal t, Tuple.load(Tuple.dump(t))
+  end
+
+  should "sort tuples using binary" do
+    tuples = [
+      [1, "foo"],
+      [1, true],
+      [2],
+      [1],
+      [nil],
+      [true],
+      [:foo, -1],
+      [:foo, -2**64],
+      [:foo,  2**64],
+      [1, "foo", 7, nil, false, true],
+      [1, "foo", 7, nil, false, false],
+      ["charles", "atlas"],
+      ["charles", "atlas", "shrugged"],
+      ["charles", "atlantic"],
+      ["charles", "atlas jr."],
+      ["charles", "atlas", "world's", "strongest", "man"],
+      ["charles", "atlas", 5],
+    ]
+
+    expected = [
+      [nil],
+      [1],
+      [1, "foo"],
+      [1, "foo", 7, nil, false, false],
+      [1, "foo", 7, nil, false, true],
+      [1, true],
+      [2],
+      ["charles", "atlantic"],
+      ["charles", "atlas"],
+      ["charles", "atlas", 5],
+      ["charles", "atlas", "shrugged"],
+      ["charles", "atlas", "world's", "strongest", "man"],
+      ["charles", "atlas jr."],
+      [:foo, -18446744073709551616],
+      [:foo, -1],
+      [:foo, 18446744073709551616],
+      [true]
+    ]  
+    assert_equal expected, tuples.sort_by {|t| Tuple.dump(t)}
+
+    100.times do
+      assert_equal expected, tuples.shuffle.sort_by {|t| Tuple.dump(t)}
+    end
+  end 
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: ninjudd-tuple
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Justin Balthrop
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-12 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Fast, binary-sortable serialization for arrays of simple Ruby types.
+email: code@justinbalthrop.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- VERSION.yml
+- test/test_helper.rb
+- test/tuple_test.rb
+has_rdoc: true
+homepage: http://github.com/ninjudd/tuple
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: []
+