roulette 0.0.1

data/.rvmrc

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+ruby_string="1.9.2"
+gemset_name="roulette"
+
+if rvm list strings | grep -q "${ruby_string}" ; then
+
+  rvm use "${ruby_string}@${gemset_name}" --create
+
+  # Complain if bundler isn't installed
+  if [[ -z "`gem which bundler 2>&1 | grep -v ERROR`" ]]; then
+    echo "You need bundler:"
+    echo ""
+    echo "    gem install bundler"
+    echo ""
+  fi
+else
+  echo "${ruby_string} was not found, please run 'rvm install ${ruby_string}' and then cd back into the project directory."
+fi

data/Gemfile

@@ -0,0 +1,12 @@
+source 'http://rubygems.org'
+
+group :development, :test do
+  gem 'rake', '~>0.8.7'
+  gem 'jeweler', '~>1.5.2'
+  gem "autotest-standalone"
+  gem "autotest-growl"
+end
+
+group :test do
+  gem 'rspec', '~> 2.5'
+end

data/Gemfile.lock

@@ -0,0 +1,30 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    autotest-growl (0.2.9)
+    autotest-standalone (4.5.5)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.2)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest-growl
+  autotest-standalone
+  jeweler (~> 1.5.2)
+  rake (~> 0.8.7)
+  rspec (~> 2.5)

data/README.md

@@ -0,0 +1,114 @@
+Roulette
+======
+`Super easy pre-sharding for your ruby NOSQL store. Presharding is used to naively scale your data-stores horizontally. `
+
+[What is presharding](http://antirez.com/post/redis-presharding.html)
+
+[Presharding at Craigslist](http://blog.zawodny.com/2011/02/26/redis-sharding-at-craigslist/)
+
+Bang
+----
+### Works with Redis ###
+    redis_array  = [Redis.new(...), Redis.new(...), Redis.new(...)]
+
+    roulette = Roulette.new(redis_array)
+    roulette.set("foo", "bar")
+    roulette.get("foo")
+    => "bar"
+
+### Works with Memcache ###
+    memcache_array  = [Memcache.new(...), Memcache.new(...), Memcache.new(...)]
+
+    roulette = Roulette.new(memcache_array)
+    roulette.set("foo", "bar")
+    roulette.get("foo")
+    => "bar"
+    
+### Works with ANY store that takes a key as it's first argument ###
+
+Simply call roulette like you would call any of your client libraries. Roulette will automatically split the data between different machines.
+
+Limitations
+-----------
+If your operator needs all the keys to be on one machine, such as reddis' SUNION, then you're out of luck. Don't use pre-sharding (yet) because this library doesn't support that.
+
+
+          .____.
+       xuu$``$$$uuu.
+     . $``$  $$$`$$$
+    dP*$  $  $$$ $$$
+    ?k $  $  $$$ $$$
+     $ $  $  $$$ $$$
+     ":$  $  $$$ $$$
+      N$  $  $$$ $$$
+      $$  $  $$$ $$$
+       $  $  $$$ $$$
+       $  $  $$$ $$$
+       $  $  $$$ $$$
+       $  $  $$$ $$$
+       $  $  $$$ $$$
+       $$#$  $$$ $$$
+       $$'$  $$$ $$$
+       $$`R  $$$ $$$
+       $$$&  $$$ $$$
+       $#*$  $$$ $$$
+       $  $  $$$ @$$
+       $  $  $$$ $$$
+       $  $  $$$ $$$
+       $  $  $B$ $$&.
+       $  $  $D$ $$$$$muL.
+       $  $  $Q$ $$$$$  `"**mu..
+       $  $  $R$ $$$$$    k  `$$*t
+       $  @  $$$ $$$$$    k   $$!4
+       $ x$uu@B8u$NB@$uuuu6...$$X?
+       $ $(`RF`$`````R$ $$5`"""#"R
+       $ $" M$ $     $$ $$$      ?
+       $ $  ?$ $     T$ $$$      $
+       $ $F H$ $     M$ $$K      $  ..
+       $ $L $$ $     $$ $$R.     "d$$$$Ns.
+       $ $~ $$ $     N$ $$X      ."    "%2h
+       $ 4k f  $     *$ $$&      R       "iN
+       $ $$ %uz!     tuuR$$:     Buu      ?`:
+       $ $F          $??$8B      | '*Ned*$~L$
+       $ $k          $'@$$$      |$.suu+!' !$
+       $ ?N          $'$$@$      $*`      d:"
+       $ dL..........M.$&$$      5       d"P
+     ..$.^"*I$RR*$C""??77*?      "nu...n*L*
+    '$C"R   ``""!$*@#""` .uor    bu8BUU+!`
+    '*@m@.       *d"     *$Rouxxd"```$
+         R*@mu.           "#$R *$    !
+         *%x. "*L               $     %.
+            "N  `%.      ...u.d!` ..ue$$$o..
+             @    ".    $*"""" .u$$$$$$$$$$$$beu...
+            8  .mL %  :R`     x$$$$$$$$$$$$$$$$$$$$$$$$$$WmeemeeWc
+           |$e!" "s:k 4      d$N"`"#$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+           $$      "N @      $?$   <F$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+           $@       ^%Uu..   R#8buu$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                      ```""*u$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                             #$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                              "5$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                                `*$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                                  ^#$$$$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                                     "*$$$$$$$$$$$$$$$$$$$$$$$$$$>
+                                       `"*$$$$$$$$$$$$$$$$$$$$$$$>
+                                           ^!$$$$$$$$$$$$$$$$$$$$>
+                                               `"#+$$$$$$$$$$$$$$>
+                                                     ""**$$$$$$$$>
+                                                            ```""
+
+
+Next Steps
+==========
+- Configuration Library
+- Support specific operations to specific shards
+
+
+Contribution
+============
+
+Fork away. If you want to chat about a feature idea, or a question you can find me on the twitters [@schneems](http://twitter.com/schneems).  Put any major changes into feature branches. Make sure all tests stay green, and make sure your changes are covered. 
+
+
+licensed under MIT License
+Copyright (c) 2011 Schneems. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "roulette"
+  gem.homepage = "http://github.com/Schnems/roulette"
+  gem.license = "MIT"
+  gem.summary = %Q{Pre-Sharding so simple you'll shoot yourself :p }
+  gem.description = %Q{
+   Super easy pre-sharding for your ruby NOSQL store. Presharding is used to naively scale your data-stores horizontally. 
+  }
+  gem.email = "richard.schneeman@gmail.com"
+  gem.authors = ["Schneems"]
+  gem.add_development_dependency "rspec"
+end
+Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/lib/roulette.rb

@@ -0,0 +1,51 @@
+
+# Roulette.config([Redis.new(..), Redis.new(...)])
+#
+# r = Roulette.new([Redis.new(..), Redis.new(...)])
+#
+#
+# Roulette.shard(:whatevs).sadd("key", "value")
+# roulette = Roulette.new(REDIS, REDIS2, REDIS3, ...)
+# roulette.set("key", "value")
+# roulette.get("key")
+# >> "value"
+
+require 'digest/sha1'
+
+class Roulette
+  attr_accessor :stores
+
+  def initialize(*stores)
+    self.stores = stores
+  end
+
+  def method_missing(method_name, *args, &blk)
+    Transaction.new(@stores, *args).fire(method_name)
+  end
+
+  class Transaction
+    attr_accessor :key, :args, :stores
+
+    def initialize(stores, *args)
+      self.stores = stores
+      self.args = *args
+      extract_args
+    end
+
+    def extract_args
+      self.key = args.first.to_s
+    end
+
+    def fire(method)
+      select_store.send method.to_sym, *args
+    end
+
+    private
+    def select_store
+      val = Digest::SHA1.hexdigest(self.key).unpack('Q').join.to_i
+      store_index = val % stores.count
+      @stores[store_index]
+    end
+  end
+
+end

data/license.txt

@@ -0,0 +1,22 @@
+licensed under MIT License:
+
+Copyright (c) 2011 Schneems
+
+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/spec/roulette/roulette_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+class FakeKeyValueStore
+  
+end
+
+
+describe Roulette do
+    describe 'method missing' do
+      before do
+        @kv_store = FakeKeyValueStore.new
+        @roulette = Roulette.new(@kv_store)
+      end
+      
+      it 'passes, key and value to the stored KV_store' do
+        @kv_store.should_receive(:sadd).with("foo", "bar")
+        @roulette.sadd("foo", "bar")
+      end
+      
+      it 'passes, key and value to the stored KV_store' do
+        @kv_store.should_receive(:sadd).with("foo", "bar")
+        @roulette.sadd("foo", "bar")
+      end
+      
+      it 'passes key to the stored KV_store' do
+        @kv_store.should_receive(:scard).with("foo")
+        @roulette.scard("foo")
+      end
+      
+      it 'passes arbitrary number of elements to the stored KV_store' do
+        @kv_store.should_receive(:fake_method).with(1,2,3,4,5,6,7,8,9,0)
+        @roulette.fake_method(1,2,3,4,5,6,7,8,9,0)
+      end
+    end
+end

data/spec/roulette/transaction_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+class FakeKeyValueStore
+  
+end
+
+
+describe Roulette::Transaction do
+    before do
+      @kv_store = FakeKeyValueStore.new
+      @key = "key"
+      @args = [@key, "value"]
+    end
+  
+    describe '#new' do
+      it "keeps args, stores, and key" do
+        transaction = Roulette::Transaction.new([@kv_store], *@args)
+        transaction.stores.should eq([@kv_store])
+        transaction.key.should eq(@key)
+        transaction.args.should eq(@args)
+      end
+    end
+    
+    describe '#extract_args' do
+      it "pulls out the key" do
+        transaction = Roulette::Transaction.new([@kv_store], *@args)
+        transaction.extract_args.should eq(@key)
+      end
+    end
+    
+    describe '#select_store' do
+      it "picks a store" do
+        transaction = Roulette::Transaction.new([@kv_store], *@args)
+        store = transaction.send :select_store 
+        store.should eq(@kv_store)
+      end
+      
+      it "selects different stores for different keys" do
+        @kv_store_deux = FakeKeyValueStore.new
+        store = Roulette::Transaction.new([@kv_store, @kv_store_deux], "key").send :select_store 
+        store_deux = Roulette::Transaction.new([@kv_store, @kv_store_deux], "different_key").send :select_store 
+        store.should_not eq(store_deux)
+      end
+    end
+    
+    describe "#fire" do
+      it "sends a method to a kv_store" do
+        fired_method = :sadd
+        @kv_store.should_receive(fired_method)
+        transaction = Roulette::Transaction.new([@kv_store], *@args)
+        transaction.fire(fired_method)
+      end
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../..', 'lib'))
+
+require 'roulette'
+require 'rspec'
+require 'rspec/autorun'
+

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification 
+name: roulette
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Schneems
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-08 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: autotest-standalone
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: autotest-growl
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+description: "\n   Super easy pre-sharding for your ruby NOSQL store. Presharding is used to naively scale your data-stores horizontally. \n  "
+email: richard.schneeman@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- VERSION
+- autotest/discover.rb
+- lib/roulette.rb
+- license.txt
+- pkg/roulette-.gem
+- pkg/roulette-0.0.1.gem
+- spec/roulette/roulette_spec.rb
+- spec/roulette/transaction_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/Schnems/roulette
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3776716065281298446
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Pre-Sharding so simple you'll shoot yourself :p
+test_files: 
+- spec/roulette/roulette_spec.rb
+- spec/roulette/transaction_spec.rb
+- spec/spec_helper.rb