schmurfy-bert 1.2.3

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,8 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+ext/bert/c/Makefile
+ext/bert/c/*.bundle
+ext/bert/c/*.o

data/History.txt

@@ -0,0 +1,31 @@
+= 1.1.2 / 2010-02-08
+  * Bug fixes
+    * Fix bignum handling on 256 byte boundary
+    * Remove unnecessary rubygems require
+
+= 1.1.1 / 2010-01-12
+  * Bug fixes
+    * require 'stringio'
+    * Fix number encoding problem on 32 bit arch
+
+= 1.1.0 / 2009-10-27
+  * Major Changes
+    * Remove reliance on Erlectricity.
+  * Bug fixes
+    * Fix unsigned int problem in C decoder
+    * Fix stack overflow segfault in C binary decoder for > 8MB binaries
+    * Optimize C bytelist decoder
+    * Fix bignum encoding
+
+= 1.0.0 / 2009-10-19
+  * No changes. Production ready!
+
+= 0.2.0 / 2009-10-15
+  * Major changes
+    * Use {time, MegaSecs, Secs, Microsecs} for time serialization
+    * Use array of options for regex serialization
+  * Tests
+    * Add roundtrip tests
+
+= 0.1.0 / 2009-10-08
+  * Birthday!

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Tom Preston-Werner
+
+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/README.md

@@ -0,0 +1,77 @@
+BERT
+====
+
+A BERT (Binary ERlang Term) serialization library for Ruby. It can
+encode Ruby objects into BERT format and decode BERT binaries into Ruby
+objects.
+
+See the BERT specification at [bert-rpc.org](http://bert-rpc.org).
+
+Instances of the following Ruby classes will be automatically converted to the
+proper simple BERT type:
+
+* Fixnum
+* Float
+* Symbol
+* Array
+* String
+
+Instances of the following Ruby classes will be automatically converted to the
+proper complex BERT type:
+
+* NilClass
+* TrueClass
+* FalseClass
+* Hash
+* Time
+* Regexp
+
+To designate tuples, simply prefix an Array literal with a `t` or use the
+BERT::Tuple class:
+
+    t[:foo, [1, 2, 3]]
+    BERT::Tuple[:foo, [1, 2, 3]]
+
+Both of these will be converted to (in Erlang syntax):
+
+    {foo, [1, 2, 3]}
+
+
+Installation
+------------
+
+    gem install bert -s http://gemcutter.org
+
+
+Usage
+-----
+
+    require 'bert'
+    
+    bert = BERT.encode(t[:user, {:name => 'TPW', :nick => 'mojombo'}])
+    # => "\203h\002d\000\004userh\002d\000\004dictl\000\000\000\002h\002d
+          \000\004namem\000\000\000\003TPWh\002d\000\004nickm\000\000\000
+          \amojomboj"
+    
+    BERT.decode(bert)
+    # => t[:user, {:name=>"TPW", :nick=>"mojombo"}]
+
+
+
+Note on Patches/Pull Requests
+-----------------------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+
+Copyright
+---------
+
+Copyright (c) 2009 Tom Preston-Werner. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,96 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "schmurfy-bert"
+    gem.summary = %Q{BERT Serializiation for Ruby}
+    gem.description = %Q{BERT Serializiation for Ruby}
+    gem.email = "tom@mojombo.com"
+    gem.homepage = "http://github.com/mojombo/bert"
+    gem.authors = ["Tom Preston-Werner"]
+    gem.add_development_dependency("thoughtbot-shoulda")
+    if ENV["JAVA"]
+      gem.extensions = nil
+      gem.platform = 'java'
+    else
+      gem.require_paths = ["lib", "ext"]
+      gem.files.include("ext")
+      gem.extensions << 'ext/bert/c/extconf.rb'
+    end
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:runtests) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :make do
+  Dir.chdir('ext/bert/c') { `ruby extconf.rb`; `make` }
+end
+
+task :clean do
+  ['rm -f ext/bert/c/*.bundle', 'rm -f ext/bert/c/*.o'].each do |cmd|
+    `#{cmd}` && puts(cmd)
+  end
+end
+
+task :test => :check_dependencies do
+  require 'fileutils'
+
+  puts "\nCleaning extension build files and running all specs in native ruby mode..."
+  ['rm -f ext/bert/c/*.bundle', 'rm -f ext/bert/c/*.o'].each do |cmd|
+    `#{cmd}` && puts(cmd)
+  end
+  pid = fork do
+    exec 'rake runtests'
+  end
+  Process.waitpid(pid)
+
+  puts "\nRunning `make` to build extensions and rerunning decoder specs..."
+  Dir.chdir('ext/bert/c') { `ruby extconf.rb`; `make` }
+  pid = fork do
+    exec 'rake runtests'
+  end
+  Process.waitpid(pid)
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "bert #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+task :console do
+  exec('irb -I lib -rbert')
+end

data/VERSION

@@ -0,0 +1 @@
+1.2.3

data/bench/bench.rb

@@ -0,0 +1,36 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'bert'
+require 'json'
+require 'yajl'
+require 'benchmark'
+
+ITER = 1_000
+
+tiny = t[:ok, :awesome]
+small = t[:ok, :answers, [42] * 42]
+large = ["abc" * 1000] * 100
+complex = [42, {:foo => 'bac' * 100}, t[(1..100).to_a]] * 10
+
+Benchmark.bm do |bench|
+  bench.report("BERT tiny") {ITER.times {BERT.decode(BERT.encode(tiny))}}
+  bench.report("BERT small") {ITER.times {BERT.decode(BERT.encode(small))}}
+  bench.report("BERT large") {ITER.times {BERT.decode(BERT.encode(large))}}
+  bench.report("BERT complex") {ITER.times {BERT.decode(BERT.encode(complex))}}
+
+  bench.report("JSON tiny") {ITER.times {JSON.load(JSON.dump(tiny))}}
+  bench.report("JSON small") {ITER.times {JSON.load(JSON.dump(small))}}
+  bench.report("JSON large") {ITER.times {JSON.load(JSON.dump(large))}}
+  bench.report("JSON complex") {ITER.times {JSON.load(JSON.dump(complex))}}
+
+  bench.report("YAJL tiny") {ITER.times {Yajl::Parser.parse(Yajl::Encoder.encode(tiny))}}
+  bench.report("YAJL small") {ITER.times {Yajl::Parser.parse(Yajl::Encoder.encode(small))}}
+  bench.report("YAJL large") {ITER.times {Yajl::Parser.parse(Yajl::Encoder.encode(large))}}
+  bench.report("YAJL complex") {ITER.times {Yajl::Parser.parse(Yajl::Encoder.encode(complex))}}
+
+  bench.report("Ruby tiny") {ITER.times {Marshal.load(Marshal.dump(tiny))}}
+  bench.report("Ruby small") {ITER.times {Marshal.load(Marshal.dump(small))}}
+  bench.report("Ruby large") {ITER.times {Marshal.load(Marshal.dump(large))}}
+  bench.report("Ruby complex") {ITER.times {Marshal.load(Marshal.dump(complex))}}
+end

data/bench/decode_bench.rb

@@ -0,0 +1,87 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'json'
+require 'yajl'
+require 'benchmark'
+
+ITER = 1_000
+
+def setup
+  tiny = t[:ok, :awesome]
+  small = t[:ok, :answers, [42] * 42]
+  large = ["abc" * 1000] * 100
+  complex = [42, {:foo => 'bac' * 100}, t[(1..100).to_a]] * 10
+
+  $tiny_encoded_bert = BERT.encode(tiny)
+  $small_encoded_bert = BERT.encode(small)
+  $large_encoded_bert = BERT.encode(large)
+  $complex_encoded_bert = BERT.encode(complex)
+
+  $tiny_encoded_json = JSON.dump(tiny)
+  $small_encoded_json = JSON.dump(small)
+  $large_encoded_json = JSON.dump(large)
+  $complex_encoded_json = JSON.dump(complex)
+
+  $tiny_encoded_yajl = Yajl::Encoder.encode(tiny)
+  $small_encoded_yajl = Yajl::Encoder.encode(small)
+  $large_encoded_yajl = Yajl::Encoder.encode(large)
+  $complex_encoded_yajl = Yajl::Encoder.encode(complex)
+
+  $tiny_encoded_ruby = Marshal.dump(tiny)
+  $small_encoded_ruby = Marshal.dump(small)
+  $large_encoded_ruby = Marshal.dump(large)
+  $complex_encoded_ruby = Marshal.dump(complex)
+end
+
+Benchmark.bm(13) do |bench|
+  pid = fork do
+    Dir.chdir(File.join(File.dirname(__FILE__), *%w[.. ext bert c])) { `make` }
+    require 'bert'
+    raise "Could not load C extension" unless BERT::Decode.impl == 'C'
+    setup
+    puts "BERT C Extension Decoder"
+    bench.report("BERT tiny")    {ITER.times {BERT.decode($tiny_encoded_bert)}}
+    bench.report("BERT small")   {ITER.times {BERT.decode($small_encoded_bert)}}
+    bench.report("BERT large")   {ITER.times {BERT.decode($large_encoded_bert)}}
+    bench.report("BERT complex") {ITER.times {BERT.decode($complex_encoded_bert)}}
+    puts
+  end
+  Process.waitpid(pid)
+
+  pid = fork do
+    Dir.chdir(File.join(File.dirname(__FILE__), *%w[.. ext bert c])) do
+      ['*.bundle', '*.o'].each { |pat| `rm -f #{pat}` }
+    end
+    require 'bert'
+    raise "Not using Ruby decoder" unless BERT::Decode.impl == 'Ruby'
+    setup
+    puts "BERT Pure Ruby Decoder"
+    bench.report("BERT tiny")    {ITER.times {BERT.decode($tiny_encoded_bert)}}
+    bench.report("BERT small")   {ITER.times {BERT.decode($small_encoded_bert)}}
+    bench.report("BERT large")   {ITER.times {BERT.decode($large_encoded_bert)}}
+    bench.report("BERT complex") {ITER.times {BERT.decode($complex_encoded_bert)}}
+    puts
+  end
+  Process.waitpid(pid)
+
+  require 'bert'
+  setup
+
+  bench.report("JSON tiny")      {ITER.times {JSON.load($tiny_encoded_json)}}
+  bench.report("JSON small")     {ITER.times {JSON.load($small_encoded_json)}}
+  bench.report("JSON large")     {ITER.times {JSON.load($large_encoded_json)}}
+  bench.report("JSON complex")   {ITER.times {JSON.load($complex_encoded_json)}}
+  puts
+
+  bench.report("YAJL tiny")      {ITER.times {Yajl::Parser.parse($tiny_encoded_yajl)}}
+  bench.report("YAJL small")     {ITER.times {Yajl::Parser.parse($small_encoded_yajl)}}
+  bench.report("YAJL large")     {ITER.times {Yajl::Parser.parse($large_encoded_yajl)}}
+  bench.report("YAJL complex")   {ITER.times {Yajl::Parser.parse($complex_encoded_yajl)}}
+  puts
+
+  bench.report("Ruby tiny")      {ITER.times {Marshal.load($tiny_encoded_ruby)}}
+  bench.report("Ruby small")     {ITER.times {Marshal.load($small_encoded_ruby)}}
+  bench.report("Ruby large")     {ITER.times {Marshal.load($large_encoded_ruby)}}
+  bench.report("Ruby complex")   {ITER.times {Marshal.load($complex_encoded_ruby)}}
+end

data/bench/encode_bench.rb

@@ -0,0 +1,36 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'bert'
+require 'json'
+require 'yajl'
+require 'benchmark'
+
+ITER = 1_000
+
+tiny = t[:ok, :awesome]
+small = t[:ok, :answers, [42] * 42]
+large = ["abc" * 1000] * 100
+complex = [42, {:foo => 'bac' * 100}, t[(1..100).to_a]] * 10
+
+Benchmark.bm(13) do |bench|
+  bench.report("BERT tiny")    {ITER.times {BERT.encode(tiny)}}
+  bench.report("BERT small")   {ITER.times {BERT.encode(small)}}
+  bench.report("BERT large")   {ITER.times {BERT.encode(large)}}
+  bench.report("BERT complex") {ITER.times {BERT.encode(complex)}}
+  puts
+  bench.report("JSON tiny")    {ITER.times {JSON.dump(tiny)}}
+  bench.report("JSON small")   {ITER.times {JSON.dump(small)}}
+  bench.report("JSON large")   {ITER.times {JSON.dump(large)}}
+  bench.report("JSON complex") {ITER.times {JSON.dump(complex)}}
+  puts
+  bench.report("JSON tiny")    {ITER.times {Yajl::Encoder.encode(tiny)}}
+  bench.report("JSON small")   {ITER.times {Yajl::Encoder.encode(small)}}
+  bench.report("JSON large")   {ITER.times {Yajl::Encoder.encode(large)}}
+  bench.report("JSON complex") {ITER.times {Yajl::Encoder.encode(complex)}}
+  puts
+  bench.report("Ruby tiny")    {ITER.times {Marshal.dump(tiny)}}
+  bench.report("Ruby small")   {ITER.times {Marshal.dump(small)}}
+  bench.report("Ruby large")   {ITER.times {Marshal.dump(large)}}
+  bench.report("Ruby complex") {ITER.times {Marshal.dump(complex)}}
+end

data/bench/results.txt

@@ -0,0 +1,55 @@
+        user     system      total        real
+
+Comparisons
+
+  JSON tiny  0.020000   0.000000   0.020000 (  0.017486)
+  JSON small  0.070000   0.000000   0.070000 (  0.080681)
+  JSON large 15.260000   0.600000  15.860000 ( 16.427857)
+  JSON complex  1.470000   0.010000   1.480000 (  1.558230)
+
+  YAJL tiny  0.010000   0.000000   0.010000 (  0.015537)
+  YAJL small  0.050000   0.000000   0.050000 (  0.061879)
+  YAJL large  3.610000   0.800000   4.410000 (  4.675255)
+  YAJL complex  1.030000   0.000000   1.030000 (  1.066871)
+
+  Ruby tiny  0.010000   0.000000   0.010000 (  0.007117)
+  Ruby small  0.020000   0.000000   0.020000 (  0.015964)
+  Ruby large  0.040000   0.000000   0.040000 (  0.042695)
+  Ruby complex  0.040000   0.000000   0.040000 (  0.048395)
+
+Ruby encoder / Ruby decoder
+41503465479e8762916d6997d91639f0d7308a13
+
+  BERT tiny  0.090000   0.000000   0.090000 (  0.092357)
+  BERT small  0.830000   0.000000   0.830000 (  0.853270)
+  BERT large  4.190000   0.620000   4.810000 (  4.959149)
+  BERT complex 19.380000   0.080000  19.460000 ( 20.402862)
+
+Simple C decoder / Ruby encoder
+41503465479e8762916d6997d91639f0d7308a13
+
+  BERT tiny  0.030000   0.000000   0.030000 (  0.033826)
+  BERT small  0.390000   0.010000   0.400000 (  0.413229)
+  BERT large  2.270000   0.550000   2.820000 (  3.029141)
+  BERT complex  8.680000   0.040000   8.720000 (  9.097990)
+
+Smarter Ruby decoder
+
+  BERT tiny  0.070000   0.000000   0.070000 (  0.075155)
+  BERT small  0.810000   0.010000   0.820000 (  0.831905)
+  BERT large  4.340000   0.600000   4.940000 (  5.064875)
+  BERT complex 18.460000   0.070000  18.530000 ( 19.096184)
+
+Smarter C decoder
+
+  BERT tiny  0.030000   0.000000   0.030000 (  0.035685)
+  BERT small  0.350000   0.010000   0.360000 (  0.358929)
+  BERT large  2.410000   0.560000   2.970000 (  3.056593)
+  BERT complex  7.910000   0.040000   7.950000 (  8.236641)
+
+Smart C Decoder only
+
+  BERT tiny  0.000000   0.000000   0.000000 (  0.001820)
+  BERT small  0.000000   0.000000   0.000000 (  0.003859)
+  BERT large  0.430000   0.010000   0.440000 (  0.499631)
+  BERT complex  0.080000   0.010000   0.090000 (  0.086992)