siberite-client 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 19cec6243d11d059f7bfad4a2702e46b969f9296
-  data.tar.gz: dd21e35e459f5ab3216b64a8aca1c4ff345646cf
+  metadata.gz: f667417977971354ef3c6d06d2d9526f73960674
+  data.tar.gz: c70be62871788f345bef4a2d45d4980e73117b08
 SHA512:
-  metadata.gz: 8e30ee5a79714a7fc193dc6c811104948a489f068ded661cb28c2ab5de317c1e0a53ed5ba8eb502cd70c2ebc739b45e794f33fcf082886a5f4c5be463db6397c
-  data.tar.gz: 81ab9257eca26190fede54f31f9db721dad780161bf04d95fd3fe5bb63087bf7999188abd88e444425d0511a49f045bb0d3bd4e5b18cdeeeb69b2b895ac5b515
+  metadata.gz: 1c080b76344a9afe9611f052beb6b548cb8752e62d9461b95136355d11ba90992cb291c0301251a112fe87ea6595a9534c9453927ed25cef767d5b71f9b5ab07
+  data.tar.gz: 229b296a8f33d3ec558e1988645bf5ff63764ec86a7df98566c1d6b1a8b9048cd9956f00d541379ff45d8736bdbf37c49ded86a13d09e87b355b475a76f32fd5

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - 2.2.0
+
+before_install:
+  - wget https://github.com/bogdanovich/siberite/releases/download/v0.6/siberite-0.6-linux_x86_64.tgz -O /tmp/siberite.tar.gz
+  - tar -xvf /tmp/siberite.tar.gz && cd siberite*
+  - ./siberite > siberite.log 2>&1 &
+
+install:
+  - bundle install

data/README.md

@@ -1,3 +1,4 @@
+[![License][License-Image]][License-Url] [![Build][Build-Status-Image]][Build-Status-Url] [![Gem Version][Gem-Image]][Gem-Url]
 ## Talk to Siberite queue server from Ruby
 
 Siberite-client is a library that allows you to talk to a [Siberite](http://github.com/bogdanovich/siberite) queue server from ruby.
@@ -27,9 +28,23 @@ See the [rdoc for Memcached](http://blog.evanweaver.com/files/doc/fauna/memcache
 ```ruby
 require 'siberite'
 
-@queue = Siberite::Client.new('localhost:22133')
-@queue.set('a_queue', 'foo')
-@queue.get('a_queue') # => 'foo'
+queue = Siberite::Client.new('localhost:22133')
+queue.set('a_queue', 'foo')
+queue.set('a_queue', 'bar')
+queue.set('a_queue', 'baz')
+
+queue.get('a_queue') # => 'foo'
+
+# opens a reliable read
+queue.get_open('a_queue') # => 'bar'
+queue.get_close('a_queue')
+
+# acknowledges previously opened read and opens a new one)
+queue.get_close_open('a_queue') # => 'baz'
+
+# raw format, skip marshalling
+queue.set('a_queue', [1,2,3].to_json, 0, raw: true)
+queue.get('a_queue', raw: true) # => "[1,2,3]"
 ```
 
 ## Client Proxies
@@ -37,13 +52,30 @@ require 'siberite'
 siberite-client comes with a number of decorators that change the behavior of the raw client.
 
 ```ruby
-@queue = Siberite::Client.new('localhost:22133')
-@queue.get('empty_queue') # => nil
-
-@queue = Siberite::Client::Blocking.new(Siberite::Client.new('localhost:22133'))
-@queue.get('empty_queue') # does not return until it pulls something from the queue
+client = Siberite::Client.new('localhost:22133')
+client.get('empty_queue') # => nil
+
+# Blocking client
+queue = Siberite::Client::Blocking.new(client)
+queue.get('empty_queue') # does not return until it pulls something from the queue
+
+# Namespaced client
+queue = Siberite::Client::Namespace.new('foo', client)
+queue.set('work', 1) # adds message to foo:work queue
+
+# Partitioned client
+client_1 = Siberite::Client.new('siberite01.example.com:22133')
+client_2 = Siberite::Client.new('siberite02.example.com:22133')
+default_client = Siberite::Client.new('siberite03.example.com:22133')
+
+client = Siberite::Client::Partitioning.new(
+    'queue1' => client_1,
+    ['queue2', 'queue3'] => client_2,
+    default: default_client
+)
 ```
 
+
 ## Configuration Management
 
 Siberite::Config provides some tools for pulling queue config out of a YAML config file.
@@ -52,7 +84,7 @@ Siberite::Config provides some tools for pulling queue config out of a YAML conf
 Siberite::Config.load 'path/to/siberite.yml'
 Siberite::Config.environment = 'production' # defaults to development
 
-@queue = Siberite::Config.new_client
+queue = Siberite::Config.new_client
 ```
 
 This tells siberite-client to look for `path/to/siberite.yml`, and pull the client configuration out of
@@ -77,3 +109,10 @@ development:
     - localhost:22133
   show_backtraces: true
 ```
+
+[License-Url]: http://opensource.org/licenses/Apache-2.0
+[License-Image]: https://img.shields.io/hexpm/l/plug.svg
+[Build-Status-Url]: https://travis-ci.org/bogdanovich/siberite-ruby
+[Build-Status-Image]: https://travis-ci.org/bogdanovich/siberite-ruby.svg?branch=master
+[Gem-Image]: https://badge.fury.io/rb/siberite-client.svg
+[Gem-Url]: https://rubygems.org/gems/siberite-client

data/Rakefile

@@ -5,6 +5,7 @@ require 'rake'
 require 'rspec/core/rake_task'
 
 task :default => :spec
+task :test => :spec
 
 desc "Run all specs in spec directory."
 RSpec::Core::RakeTask.new(:spec) do |t|

data/lib/siberite/client.rb

@@ -143,7 +143,23 @@ module Siberite
     end
 
     def peek(queue)
-      get queue, :peek => true
+      get queue, peek: true
+    end
+
+    def get_open(queue)
+      get queue, open: true
+    end
+
+    def get_close(queue)
+      get_from_last queue, close: true
+    end
+
+    def get_close_open(queue)
+      get_from_last queue, close: true, open: true
+    end
+
+    def get_abort(queue)
+      get_from_last queue, abort: true
     end
 
     private
@@ -173,7 +189,7 @@ module Siberite
     end
 
     def extract_queue_commands(opts)
-      commands = [:open, :close, :abort, :peek].select do |key|
+      commands = [:close, :open, :abort, :peek].select do |key|
         opts[key]
       end
 

data/lib/siberite/client/version.rb

@@ -1,3 +1,3 @@
 module Siberite
-  VERSION = "0.8.1"
+  VERSION = "0.9.0"
 end

data/siberite-client.gemspec

@@ -30,6 +30,6 @@ Gem::Specification.new do |s|
   s.add_development_dependency "rspec", "~> 3.2"
   s.add_development_dependency "rr", "~> 1.1"
   s.add_development_dependency "activesupport", "> 3.1"
-  s.add_development_dependency "bundler", "~> 1.7"
+  s.add_development_dependency "bundler"
   s.add_development_dependency "rake", "~> 10.0"
 end

data/spec/siberite/client_spec.rb

@@ -81,6 +81,51 @@ describe Siberite::Client do
       end
     end
 
+    describe "#get_open" do
+      it "opens a reliable read" do
+        @queue = "some_random_queue_#{Time.now.to_i}_#{rand(10000)}"
+        @client.set(@queue, "item_1")
+        @client.set(@queue, "item_2")
+        expect(@client.get_open(@queue)).to eq "item_1"
+        expect{ @client.get(@queue) }.to raise_error Memcached::ClientError
+        expect(@client.get_open(@queue)).to eq "item_1"
+      end
+    end
+
+    describe "#get_close" do
+      it "closes a reliable read" do
+        @queue = "some_random_queue_#{Time.now.to_i}_#{rand(10000)}"
+        @client.set(@queue, "item_1")
+        @client.set(@queue, "item_2")
+        expect(@client.get_open(@queue)).to eq "item_1"
+        expect{ @client.get_close(@queue) }.to_not raise_error
+        expect(@client.get_open(@queue)).to eq "item_2"
+      end
+    end
+
+    describe "#get_close_open" do
+      it "closes a reliable read" do
+        @queue = "some_random_queue_#{Time.now.to_i}_#{rand(10000)}"
+        @client.set(@queue, "item_1")
+        @client.set(@queue, "item_2")
+        expect(@client.get_open(@queue)).to eq "item_1"
+        expect{ @client.get(@queue) }.to raise_error Memcached::ClientError
+        expect(@client.get_open(@queue)).to eq "item_1"
+        expect(@client.get_close_open(@queue)).to eq "item_2"
+      end
+    end
+
+    describe "#get_abort" do
+      it "aborts a reliable read" do
+        @queue = "some_random_queue_#{Time.now.to_i}_#{rand(10000)}"
+        @client.set(@queue, "item_1")
+        @client.set(@queue, "item_2")
+        expect(@client.get_open(@queue)).to eq "item_1"
+        expect{ @client.get_abort(@queue) }.to_not raise_error
+        expect(@client.get(@queue)).to eq "item_1"
+      end
+    end
+
     describe "#with_retries" do
       it "retries a specified number of times" do
         mock(@client).set(anything, anything) { raise Memcached::SystemError }.times(6)

data/spec/siberite/config_spec.rb

@@ -9,10 +9,12 @@ describe Siberite::Config do
   describe "load" do
     it "loads a yaml file" do
       Siberite::Config.config = nil
-      lambda { Siberite::Config.default }.should raise_error
+      expect {
+        Siberite::Config.default
+      }.to raise_error Siberite::Config::ConfigNotLoaded
 
       Siberite::Config.load TEST_CONFIG_FILE
-      lambda { Siberite::Config.default }.should_not raise_error
+      expect { Siberite::Config.default }.to_not raise_error
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: siberite-client
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Matt Freels
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-24 00:00:00.000000000 Z
+date: 2015-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: memcached
@@ -100,16 +100,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -132,6 +132,7 @@ extra_rdoc_files:
 - README.md
 files:
 - .gitignore
+- .travis.yml
 - Gemfile
 - LICENSE
 - README.md