sparqcode_bunny 0.0.1

data/.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+.*.swp
+*.class
+*.rbc
+*.gem
+/doc/
+.yardoc
+.rvmrc
+Gemfile.lock
+.rbx/*

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format
+progress

data/.travis.yml

@@ -0,0 +1,15 @@
+# https://github.com/travis-ci/travis-ci/wiki/.travis.yml-options
+bundler_args: --without development
+script: "bundle exec rspec spec"
+rvm:
+  - 1.8.7
+  - ree
+  - 1.9.2
+  - 1.9.3
+  - rbx-2.0
+notifications:
+  recipients:
+    - celldee@gmail.com
+    - jakub@rabbitmq.com
+    - skaes@railsexpress.de
+    - eric@5stops.com

data/.yardopts

@@ -0,0 +1,9 @@
+--no-private
+--protected
+--markup="textile" lib/**/*.rb
+--main README.textile
+--asset examples:examples
+--hide-tag todo
+-
+LICENSE
+CHANGELOG

data/CHANGELOG

@@ -0,0 +1,27 @@
+= Version 0.7.8
+
+ * test suite cleanup (eliminated some race conditions related to queue.message_count)
+
+= Version 0.7.7
+
+ * avoid warnings caused by duplicating code from the amq-client gem
+
+= Version 0.7.6
+
+ * API mismatch between Timer/SystemTimer on Ruby 1.9 vs Ruby 1.8 is resolved.
+
+= Version 0.7.3
+
+  * AMQP connection URI parser now respects port
+
+= Version 0.7.2
+
+ * Fixes for irb tab completion
+
+= Version 0.7.0
+
+ * Added :content_type option to Exchange#publish
+ * Lots of minor fixes
+
+= Version 0.6.3
+  * Encoding of source files is set to UTF-8 on Ruby 1.9.

data/Gemfile

@@ -0,0 +1,39 @@
+# encoding: utf-8
+
+source :rubygems
+
+# Use local clones if possible.
+# If you want to use your local copy, just symlink it to vendor.
+# See http://blog.101ideas.cz/posts/custom-gems-in-gemfile.html
+extend Module.new {
+  def gem(name, *args)
+    options = args.last.is_a?(Hash) ? args.last : Hash.new
+
+    local_path = File.expand_path("../vendor/#{name}", __FILE__)
+    if File.exist?(local_path)
+      super name, options.merge(:path => local_path).
+        delete_if { |key, _| [:git, :branch].include?(key) }
+    else
+      super name, *args
+    end
+  end
+}
+
+gem "SystemTimer", "1.2", :platform => :ruby_18
+
+group :development do
+  gem "rake"
+
+  gem "yard", ">= 0.7.2"
+
+  # Yard tags this buddy along.
+  gem "RedCloth",  :platform => :mri
+
+  gem "changelog"
+end
+
+group :test do
+  gem "rspec", "~> 2.6.0"
+end
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2009 – 2011 Chris Duncan, Jakub Stastny aka botanicus,
+Michael S. Klishin, Eric Lindvall, Stefan Kaes and contributors.
+
+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.textile

@@ -0,0 +1,82 @@
+h1. About
+
+Bunny is a synchronous "AMQP":http://bit.ly/hw2ELX client. It supports Ruby 1.9.2, 1.8.7, Ruby Enterprise Edition and JRuby. Protocol-wise, Bunny supports AMQP 0.9.1 and 0.8. Support for AMQP 0.8 will be dropped in the next version of Bunny (0.7) because most of popular AMQP brokers such as RabbitMQ already stopped or planning to stop supporting it in the near future.
+
+Bunny is based on a great deal of useful code from the "amqp Ruby gem":http://github.com/ruby-amqp/amqp and "Carrot":http://github.com/famoseagle/carrot.
+
+You can use Bunny to:
+
+* Create and delete exchanges
+* Create and delete queues
+* Publish and consume messages
+
+h1. Differences from Official Gem
+
+We have added two things to the gem:
+* the ability to unsubscribe from a queue once the queue is empty (unreliable)
+* the ability to break out of a subscription loop if a condition has been met
+
+h1. Quick Start
+
+<pre>
+require "bunny"
+
+b = Bunny.new(:logging => true)
+
+# start a communication session with the amqp server
+b.start
+b.qos # must be enabled for rpc features to work
+
+# declare a queue
+q = b.queue("test1")
+e = b.exchange('')
+
+correlation_id = 123
+
+# publish a message to the queue
+e.publish("Junk", :key => q.name, :correlation_id => 0)
+e.publish("Junk", :key => q.name, :correlation_id => 1)
+e.publish("Hello everybody!", :key => q.name, :correlation_id => correlation_id)
+e.publish("Junk", :key => q.name, :correlation_id => 2)
+
+expected_msg = nil
+
+# get message from the queue
+q.subscribe(:ack => true) do |msg|
+	if msg[:header].attributes[:correlation_id].to_i == correlation_id
+		expected_msg = msg[:payload] 
+		msg[:subscribed] = false
+	end
+end
+
+puts "This is the correct message: " + expected_msg + "\n\n"
+
+# close the connection
+b.stop
+</pre>
+
+... or just:
+
+<pre>
+require "bunny"
+
+# Create a direct queue named "my_testq"
+Bunny.run { |c| c.queue("my_testq") }
+</pre>
+
+Please see the @examples@ directory for additional usage information.
+
+h2. Intended Use
+
+# Generate a correlation_id
+# Send a message to the queue with the correlation_id set
+# Subscribe to the reply queue
+# Process messages until you get the correlation_id you want
+# tell the subscription you are no longer interested in messages
+
+h1. Links
+
+* "Source code":http://github.com/sparqcode/bunny
+* "@rubyamqp":http://twitter.com/rubyamqp at Twitter
+* "Ruby AMQP Google Group":http://groups.google.com/group/ruby-amqp
+* "Blog":http://bunnyamqp.wordpress.com

data/Rakefile

@@ -0,0 +1,14 @@
+# encoding: utf-8
+
+require "bundler/gem_tasks"
+
+desc "Run rspec tests"
+task :spec do
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new("spec") do |t|
+    t.pattern = "spec/spec_*/*_spec.rb"
+    t.rspec_opts = ['--color', '--format doc']
+  end
+end
+
+task :default => [ :spec ]

data/bunny.gemspec

@@ -0,0 +1,43 @@
+#!/usr/bin/env gem build
+# encoding: utf-8
+
+require "base64"
+require File.expand_path("../lib/bunny/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name = "sparqcode_bunny"
+  s.version = Bunny::VERSION.dup
+  s.homepage = "http://github.com/sparqcode/bunny"
+  s.summary = "Bunny with some RPC friendly extensions"
+  s.description = "A synchronous Ruby AMQP client that enables interaction with AMQP-compliant brokers with minor modifications to make RPC easier.  The official gem will be best for you 99.9973% of the time."
+
+  # Sorted alphabetically.
+  s.authors = [
+    "Chris Duncan",
+    "Eric Lindvall",
+    "Jakub Stastny aka botanicus",
+    "Michael S. Klishin",
+    "Stefan Kaes"]
+
+  s.email = [
+    "Y2VsbGRlZUBnbWFpbC5jb20=\n",
+    "ZXJpY0A1c3RvcHMuY29t\n",
+    "c3Rhc3RueUAxMDFpZGVhcy5jeg==\n",
+    "bWljaGFlbEBub3ZlbWJlcmFpbi5jb20=\n",
+    "c2thZXNAcmFpbHNleHByZXNzLmRl\n"].
+    map { |mail| Base64.decode64(mail) }
+
+  # Files.
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.textile"]
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.require_paths = ["lib"]
+
+  begin
+    require "changelog"
+    s.post_install_message = CHANGELOG.new.version_changes
+  rescue LoadError
+  end
+end

data/examples/simple_08.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+# simple_08.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true)
+
+# start a communication session with the amqp server
+b.start
+
+# declare a queue
+q = b.queue('test1')
+
+# publish a message to the queue
+q.publish('➸ Hello everybody ☺!')
+
+# get message from the queue
+msg = q.pop[:payload]
+
+puts 'This is the message: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_09.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+# simple_09.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true, :spec => '09')
+
+# start a communication session with the amqp server
+b.start
+
+# declare a queue
+q = b.queue('test1')
+
+# publish a message to the queue
+q.publish('➸ Hello everybody ☺!')
+
+# get message from the queue
+msg = q.pop[:payload]
+
+puts 'This is the message: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_ack_08.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+# simple_ack_08.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true)
+
+# start a communication session with the amqp server
+b.start
+
+# declare a queue
+q = b.queue('test1')
+
+# publish a message to the queue
+q.publish('Testing acknowledgements')
+
+# get message from the queue
+msg = q.pop(:ack => true)[:payload]
+
+# acknowledge receipt of message
+q.ack
+
+puts 'This is the message: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_ack_09.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+# simple_ack_09.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true, :spec => '09')
+
+# start a communication session with the amqp server
+b.start
+
+# declare a queue
+q = b.queue('test1')
+
+# publish a message to the queue
+q.publish('Testing acknowledgements')
+
+# get message from the queue
+msg = q.pop(:ack => true)[:payload]
+
+# acknowledge receipt of message
+q.ack
+
+puts 'This is the message: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_consumer_08.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+
+# simple_consumer_08.rb
+
+# N.B. To be used in conjunction with simple_publisher.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+# How this example works
+#=======================
+#
+# Open up two console windows start this program in one of them by typing -
+#
+# ruby simple_consumer_08.rb
+#
+# Then switch to the other console window and type -
+#
+# ruby simple_publisher_08.rb
+#
+# A message will be printed out by the simple_consumer and it will wait for the next message
+# until the timeout interval is reached.
+#
+# Run simple_publisher as many times as you like. When you want the program to stop just stop
+# sending messages and the subscribe loop will timeout after 30 seconds, the program will
+# unsubscribe from the queue and close the connection to the server.
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true)
+
+# start a communication session with the amqp server
+b.start
+
+# create/get queue
+q = b.queue('po_box')
+
+# create/get exchange
+exch = b.exchange('sorting_room')
+
+# bind queue to exchange
+q.bind(exch, :key => 'fred')
+
+# subscribe to queue
+q.subscribe(:consumer_tag => 'testtag1', :timeout => 30) do |msg|
+  puts "#{q.subscription.message_count}: #{msg[:payload]}"
+end
+
+# Close client
+b.stop

data/examples/simple_consumer_09.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+
+# simple_consumer_09.rb
+
+# N.B. To be used in conjunction with simple_publisher.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+# How this example works
+#=======================
+#
+# Open up two console windows start this program in one of them by typing -
+#
+# ruby simple_consumer_09.rb
+#
+# Then switch to the other console window and type -
+#
+# ruby simple_publisher_09.rb
+#
+# A message will be printed out by the simple_consumer and it will wait for the next message
+# until the timeout interval is reached.
+#
+# Run simple_publisher as many times as you like. When you want the program to stop just stop
+# sending messages and the subscribe loop will timeout after 30 seconds, the program will
+# unsubscribe from the queue and close the connection to the server.
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true, :spec => '09')
+
+# start a communication session with the amqp server
+b.start
+
+# create/get queue
+q = b.queue('po_box')
+
+# create/get exchange
+exch = b.exchange('sorting_room')
+
+# bind queue to exchange
+q.bind(exch, :key => 'fred')
+
+# subscribe to queue
+q.subscribe(:consumer_tag => 'testtag1', :timeout => 30) do |msg|
+  puts "#{q.subscription.message_count}: #{msg[:payload]}"
+end
+
+# Close client
+b.stop

data/examples/simple_fanout_08.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+# simple_fanout_08.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true)
+
+# start a communication session with the amqp server
+b.start
+
+# declare queues
+q1 = b.queue('test_fan1')
+q2 = b.queue('test_fan2')
+
+# create a fanout exchange
+exch = b.exchange('test_fan', :type => :fanout)
+
+# bind the queues to the exchange
+q1.bind(exch)
+q2.bind(exch)
+
+# publish a message to the exchange
+exch.publish('This message will be fanned out')
+
+# get message from the queues
+msg = q1.pop[:payload]
+puts 'This is the message from q1: ' + msg + "\n\n"
+msg = q2.pop[:payload]
+puts 'This is the message from q2: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_fanout_09.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+# simple_fanout_09.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new(:logging => true, :spec => '09')
+
+# start a communication session with the amqp server
+b.start
+
+# declare queues
+q1 = b.queue('test_fan1')
+q2 = b.queue('test_fan2')
+
+# create a fanout exchange
+exch = b.exchange('test_fan', :type => :fanout)
+
+# bind the queues to the exchange
+q1.bind(exch)
+q2.bind(exch)
+
+# publish a message to the exchange
+exch.publish('This message will be fanned out')
+
+# get message from the queues
+msg = q1.pop[:payload]
+puts 'This is the message from q1: ' + msg + "\n\n"
+msg = q2.pop[:payload]
+puts 'This is the message from q2: ' + msg + "\n\n"
+
+# close the client connection
+b.stop

data/examples/simple_headers_08.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+# simple_headers_08.rb
+
+# Assumes that target message broker/server has a user called 'guest' with a password 'guest'
+# and that it is running on 'localhost'.
+
+# If this is not the case, please change the 'Bunny.new' call below to include
+# the relevant arguments e.g. b = Bunny.new(:user => 'john', :pass => 'doe', :host => 'foobar')
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'bunny'
+
+b = Bunny.new
+
+# start a communication session with the amqp server
+b.start
+
+# declare queues
+q = b.queue('header_q1')
+
+# create a headers exchange
+header_exch = b.exchange('header_exch', :type => :headers)
+
+# bind the queue to the exchange
+q.bind(header_exch, :arguments => {'h1'=>'a','x-match'=>'all'})
+
+# publish messages to the exchange
+header_exch.publish('Headers test msg 1', :headers => {'h1'=>'a'})
+header_exch.publish('Headers test msg 2', :headers => {'h1'=>'z'})
+
+
+# get messages from the queue - should only be msg 1 that got through
+msg = ""
+until msg == :queue_empty do
+  msg = q.pop[:payload]
+  puts 'This is a message from the header_q1 queue: ' + msg + "\n" unless msg == :queue_empty
+end
+
+# close the client connection
+b.stop