libsnappy 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,33 @@
+# Snappy
+
+Ruby wrapper for Google's fast compressor/decompressor: http://code.google.com/p/snappy/
+
+Snappy is a compression/decompression library. It does not aim for maximum compression, or compatibility with any other compression library; instead, it aims for very high speeds and reasonable compression. For instance, compared to the fastest mode of zlib, Snappy is an order of magnitude faster for most inputs, but the resulting compressed files are anywhere from 20% to 100% bigger. On a single core of a Core i7 processor in 64-bit mode, Snappy compresses at about 250 MB/sec or more and decompresses at about 500 MB/sec or more.
+
+Snappy is widely used inside Google, in everything from BigTable and MapReduce to our internal RPC systems. (Snappy has previously been referred to as “Zippy” in some presentations and the likes.)
+
+## Installation
+
+- Grab the latest Snappy build and install it on your system:
+    - [http://code.google.com/p/snappy/](http://code.google.com/p/snappy/)
+- You may need 'Google Test' and 'Google Flags' to build Snappy:
+    - [http://code.google.com/p/googletest/](http://code.google.com/p/googletest/])
+    - [http://code.google.com/p/google-gflags/](http://code.google.com/p/google-gflags/)
+
+Once you have Snappy installed on your system, you can install the gem:
+
+    gem install libsnappy
+
+## Example
+
+    compressed = Snappy.compress('string to compress')
+    uncompressed = Snappy.uncompress(compressed)
+
+For benchmarks and motivation behind Snappy see:
+
+- [http://blog.sesse.net/blog/tech/2011-03-22-19-24_snappy](http://blog.sesse.net/blog/tech/2011-03-22-19-24_snappy)
+- [http://pastebin.com/SFaNzRuf](http://pastebin.com/SFaNzRuf)
+
+### License
+
+(MIT License) - Copyright (c) 2011 Ilya Grigorik

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+require 'rake/extensiontask'
+
+Rake::ExtensionTask.new do |ext|
+  ext.name = 'libsnappy'
+  ext.ext_dir = 'ext'
+  ext.lib_dir = 'lib'
+  ext.config_script = 'extconf.rb'
+end
+
+desc "Run all RSpec tests"
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Build libsnappy, then run tests."
+task :default => [:compile, :spec]

data/ext/extconf.rb

@@ -0,0 +1,6 @@
+require 'mkmf'
+
+extension_name = 'libsnappy'
+$LIBS << " -lstdc++ -lsnappy"
+
+create_makefile(extension_name)

data/ext/libsnappy.cc

@@ -0,0 +1,40 @@
+#include <ruby.h>
+#include <snappy.h>
+
+using namespace snappy;
+
+typedef VALUE (ruby_method)(...);
+
+extern "C" VALUE compress(VALUE self, VALUE input) {
+ string *out = new string();
+
+ size_t sz = snappy::Compress(RSTRING_PTR(input), RSTRING_LEN(input), out);
+ VALUE ret = rb_str_new(out->c_str(), sz);
+ delete out;
+
+ return ret;
+}
+
+extern "C" VALUE uncompress(VALUE self, VALUE input) {
+ VALUE ret;
+ string *out = new string();
+
+ bool pass = snappy::Uncompress(RSTRING_PTR(input), RSTRING_LEN(input), out);
+
+ if (pass)
+   ret = rb_str_new(out->c_str(), out->length());
+ else
+   ret = Qnil;
+
+ delete out;
+ return ret;
+}
+
+static VALUE RSnappy;
+
+extern "C" void Init_libsnappy()
+{
+   RSnappy = rb_define_class("Snappy", rb_cObject);
+   rb_define_singleton_method(RSnappy, "compress", (ruby_method*) &compress, 1);
+   rb_define_singleton_method(RSnappy, "uncompress", (ruby_method*) &uncompress, 1);
+}

data/libsnappy.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "libsnappy"
+  s.version     = "0.1.0"
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Ilya Grigorik", "Michael Bernstein"]
+  s.email       = ["ilya@igvita.com", "michael@spaceshipknows.com"]
+  s.homepage    = "http://code.google.com/p/snappy/"
+  s.summary     = "Snappy, a fast compressor/decompressor (courtesy of Google)"
+  s.description = s.summary
+
+  s.rubyforge_project = "libsnappy"
+  s.extensions = ["ext/extconf.rb"]
+
+  s.add_development_dependency "rake-compiler", "0.7.6"
+  s.add_development_dependency "rspec"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/snappy_spec.rb

@@ -0,0 +1,26 @@
+require 'rspec'
+require 'libsnappy'
+
+describe Snappy do
+  it 'should compress data' do
+    lambda do
+      Snappy.compress('abcdefg')
+    end.should_not raise_error
+  end
+
+  it 'should uncompress data' do
+    lambda do
+      Snappy.uncompress(Snappy.compress('abcdefg'))
+    end.should_not raise_error
+  end
+
+  it 'should roundtrip the data' do
+    original = 'abcdefg' * 100
+
+    compressed = Snappy.compress(original)
+    uncompressed = Snappy.uncompress(compressed)
+
+    original.should == uncompressed
+    compressed.size.should < original.size
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: libsnappy
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Ilya Grigorik
+- Michael Bernstein
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-27 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake-compiler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 0.7.6
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Snappy, a fast compressor/decompressor (courtesy of Google)
+email: 
+- ilya@igvita.com
+- michael@spaceshipknows.com
+executables: []
+
+extensions: 
+- ext/extconf.rb
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- ext/extconf.rb
+- ext/libsnappy.cc
+- libsnappy.gemspec
+- spec/snappy_spec.rb
+has_rdoc: true
+homepage: http://code.google.com/p/snappy/
+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: libsnappy
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Snappy, a fast compressor/decompressor (courtesy of Google)
+test_files: 
+- spec/snappy_spec.rb