amq-client 0.5.0

data/.gitignore

@@ -0,0 +1,8 @@
+/*.gem
+.bundle
+vendor/bundle
+.yardoc/*
+doc/*
+.rvmrc
+# see http://bit.ly/h2WJPm for reasoning
+Gemfile.lock

data/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "vendor/amq-protocol"]
+	path = vendor/amq-protocol
+	url = https://github.com/ruby-amqp/amq-protocol.git
+[submodule "vendor/cool.io"]
+	path = vendor/cool.io
+	url = https://github.com/tarcieri/cool.io.git
+[submodule "vendor/evented-spec"]
+	path = vendor/evented-spec
+	url = git://github.com/markiz/evented-spec.git

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format nested

data/.travis.yml

@@ -0,0 +1,7 @@
+script: "bundle exec rspec spec"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree
+  - rbx
+  - jruby

data/.yardopts

@@ -0,0 +1 @@
+--no-private --protected lib/amq/**/*.rb

data/CONTRIBUTORS

@@ -0,0 +1,3 @@
+Michael S. Klishin: 102 (7770 LOC)
+Jakub Šťastný aka Botanicus: 49 (2103 LOC)
+Mark Abramov: 13 (947 LOC)

data/Gemfile

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+source :rubygems
+
+gem "eventmachine", "0.12.10" #, "1.0.0.beta.3"
+# cool.io uses iobuffer that won't compile on JRuby
+# (and, probably, Windows)
+gem "cool.io", :platform => :ruby
+gem "amq-protocol", :git => "git://github.com/ruby-amqp/amq-protocol.git", :branch => "master"
+
+group :development do
+  gem "yard"
+  # yard tags this buddy along
+  gem "RedCloth"
+
+  gem "nake",          :platform => :ruby_19
+  gem "contributors",  :platform => :ruby_19
+
+  # excludes Windows and JRuby
+  gem "perftools.rb",  :platform => :mri
+end
+
+group :test do
+  gem "rspec", ">=2.0.0"
+  gem "autotest"
+  gem "evented-spec", :git => "git://github.com/ruby-amqp/evented-spec.git", :branch => "master"
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Jakub Šťastný aka Botanicus
+
+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,61 @@
+h2. About amq-client
+
+amq-client is a fully-featured, low-level AMQP 0.9.1 client that runs on Ruby 1.8.7, 1.9.2, REE, Rubinius and JRuby.
+It's sweet spot is in serving as foundation for higher-level, more opinionated AMQP libraries.
+It can be used directly by applications code when performance and access to
+advanced AMQP protocol features is more important that API convenience.
+
+h2(#amqp_gems_family). How does amq-client relate to amqp gem, amq-protocol and libraries like bunny?
+
+<pre>
+|--------------|      |-----------------------|      |----------------------|
+| AMQ-Protocol |      | AMQ-Client            |      | AMQP gem, bunny, etc |
+|  - Encoding  | ===> |  - IO abstraction     | ===> |  - high-level API    |
+|  - Decoding  |      |  - Low-level AMQP API |      |  - opinionated       |
+|  - Framing   |      |-----------------------|      |----------------------|
+|--------------|
+
+</pre>
+
+ * At the lowest level, "AMQ-Protocol gem":http://github.com/ruby-amqp/amq-protocol takes care of encoding, decoding and framing.
+ * One level above is "AMQ-Client gem":http://github.com/ruby-amqp/amq-client that takes care of network I/O, provides uniform interface for
+various I/O libraries like "EventMachine":http://rubyeventmachine.com/, "cool.io":http://coolio.github.com/ or good old TCP sockets and implements
+AMQP protocol entities (queues, exchanges, channels and so on) with emphasis on access to every feature available over API convenience or
+conciseness.
+ * Finally, end applications use 
+
+h2. Adapters
+
+Version 1.0 will feature 3 adapters:
+
+ * EventMachine (asynchronous)
+ * cool.io (asynchronous)
+ * TCP sockets (synchronous)
+
+h2. Installation
+
+If you use Bundler and want to use the very latest version, add this to your Gemfile:
+
+<pre>
+gem 'amq-client', :git => 'https://github.com/ruby-amqp/amq-client.git'
+</pre>
+
+
+h2. Nightly Builds
+
+You can always find nightly builds at "gems.101ideas.cz":http://gems.101ideas.cz.
+You can install them thusly:
+
+<pre>
+wget http://gems.101ideas.cz/amq-client-nightly.gem
+gem install amq-client-nightly.gem
+</pre>
+
+h2. See also
+
+* "API documentation":http://rdoc.info/github/ruby-amqp/amq-client/master/frames
+* "Examples":https://github.com/ruby-amqp/amq-client/tree/master/examples/
+* "Jabber room for contributors":xmpp://amqp-dev@conf.netlab.cz
+* "Ruby AMQP mailing list":http://groups.google.com/group/ruby-amqp
+* "Issue tracker":http://github.com/ruby-amqp/amq-client/issues
+* "Continous integration server":http://travis-ci.org/#!/ruby-amqp/amq-client

data/amq-client.gemspec

@@ -0,0 +1,34 @@
+#!/usr/bin/env gem build
+# encoding: utf-8
+
+require "base64"
+require File.expand_path("../lib/amq/client/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name = "amq-client"
+  s.version = AMQ::Client::VERSION.dup
+  s.authors = ["Jakub Stastny", "Michael S. Klishin", "Theo Hultberg", "Mark Abramov"]
+  s.email   = [Base64.decode64("c3Rhc3RueUAxMDFpZGVhcy5jeg==\n"), "michael@novemberain.com"]
+  s.homepage = "http://github.com/ruby-amqp/amq-client"
+  s.summary = "amq-client is a fully-featured, low-level AMQP 0.9.1 client"
+  s.description = <<-DESC
+  amq-client supports multiple networking adapters (EventMachine, TCP sockets, cool.io) and
+  supposed to back more opinionated AMQP clients (such as amqp gem, bunny, et cetera) or be used directly
+  in cases when access to more advanced AMQP 0.9.1 features is more important that convenient APIs
+  DESC
+  s.cert_chain = nil
+  s.has_rdoc   = true
+
+  # files
+  s.files = `git ls-files`.split("\n").reject { |file| file =~ /^vendor\// }
+  s.require_paths = ["lib"]
+  s.extra_rdoc_files = ["README.textile"] + Dir.glob("doc/*")
+
+  # Dependencies
+  s.add_dependency "eventmachine", "~> 0.12.10"
+  s.add_dependency "amq-protocol"
+
+
+  # RubyForge
+  s.rubyforge_project = "amq-client"
+end

data/bin/jenkins.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+echo -e "\n\n==== Setup ===="
+source /etc/profile
+git fetch && git reset origin/master --hard
+
+echo -e "\n\n==== Ruby 1.9.2 Head ===="
+rvm use 1.9.2-head@ruby-amqp
+gem install bundler --no-ri --no-rdoc
+bundle install --path vendor/bundle/1.9.2 --without development; echo
+bundle update amq-protocol evented-spec; echo
+bundle exec rspec spec
+return_status=$?
+
+echo -e "\n\n==== Ruby 1.8.7 ===="
+rvm use 1.8.7@ruby-amqp
+gem install bundler --no-ri --no-rdoc
+bundle install --path vendor/bundle/1.8.7 --without development; echo
+bundle update; echo
+bundle exec rspec spec
+return_status=$(expr $return_status + $?)
+
+test $return_status -eq 0

data/bin/set_test_suite_realms_up.sh

@@ -0,0 +1,24 @@
+#!/bin/sh
+
+# guest:guest has full access to /
+
+rabbitmqctl add_vhost /
+rabbitmqctl add_user guest guest
+rabbitmqctl set_permissions -p / guest ".*" ".*" ".*"
+
+
+# guest:guest has full access to /amq_client_testbed
+# amq_client_gem:amq_client_gem has full access to /amq_client_testbed
+
+rabbitmqctl delete_vhost "/amq_client_testbed"
+rabbitmqctl add_vhost "/amq_client_testbed"
+rabbitmqctl delete_user amq_client_gem
+rabbitmqctl add_user amq_client_gem amq_client_gem_password
+rabbitmqctl set_permissions -p /amq_client_testbed guest ".*" ".*" ".*"
+rabbitmqctl set_permissions -p /amq_client_testbed amq_client_gem ".*" ".*" ".*"
+
+
+# amqp_gem_reader:reader_password has read access to /amq_client_testbed
+
+rabbitmqctl add_user amq_client_gem_reader reader_password
+rabbitmqctl set_permissions -p /amq_client_testbed amq_client_gem_reader "^---$" "^---$" ".*"

data/examples/coolio_adapter/basic_consume.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Set a queue up for message delivery" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open!"
+  end
+
+  queue = AMQ::Client::Queue.new(client, channel)
+  queue.declare(false, false, false, true) do
+    puts "Server-named, auto-deletable Queue #{queue.name.inspect} is ready"
+  end
+
+  queue.bind("amq.fanout") do
+    puts "Queue #{queue.name} is now bound to amq.fanout"
+  end
+
+  queue.consume(true) do |consumer_tag|
+    puts "Subscribed for messages routed to #{queue.name}, consumer tag is #{consumer_tag}, using no-ack mode"
+    puts
+
+    queue.on_delivery do |header, payload, consumer_tag, delivery_tag, redelivered, exchange, routing_key|
+      puts "Got a delivery:"
+      puts "    Delivery tag: #{delivery_tag}"
+      puts "    Header:  #{header.inspect}"
+      puts "    Payload: #{payload.inspect}"
+    end
+
+    exchange = AMQ::Client::Exchange.new(client, channel, "amq.fanout", :fanout)
+    100.times do |i|
+      exchange.publish("Message ##{i}")
+    end
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      Coolio::Loop.default.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+end

data/examples/coolio_adapter/basic_consume_with_acknowledgements.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Set a queue up for message delivery" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open!"
+  end
+
+  queue = AMQ::Client::Queue.new(client, channel)
+  queue.declare
+
+  queue.bind("amq.fanout") do
+    puts "Queue #{queue.name} is now bound to amq.fanout"
+  end
+
+  queue.consume do |consumer_tag|
+    queue.on_delivery do |header, payload, consumer_tag, delivery_tag, redelivered, exchange, routing_key|
+      puts "Got a delivery: #{payload} (delivery tag: #{delivery_tag}), ack-ing..."
+
+      queue.acknowledge(delivery_tag)
+    end
+
+    exchange = AMQ::Client::Exchange.new(client, channel, "amq.fanout", :fanout)
+    10.times do |i|
+      exchange.publish("Message ##{i}")
+    end
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      Coolio::Loop.default.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+end

data/examples/coolio_adapter/basic_consume_with_rejections.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Set a queue up for message delivery" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open!"
+  end
+
+  queue = AMQ::Client::Queue.new(client, channel)
+  queue.declare
+
+  queue.bind("amq.fanout") do
+    puts "Queue #{queue.name} is now bound to amq.fanout"
+  end
+
+  queue.consume do |consumer_tag|
+    queue.on_delivery do |header, payload, consumer_tag, delivery_tag, redelivered, exchange, routing_key|
+      puts "Got a delivery: #{payload} (delivery tag: #{delivery_tag}), rejecting..."
+
+      queue.reject(delivery_tag, false)
+    end
+
+    exchange = AMQ::Client::Exchange.new(client, channel, "amq.fanout", :fanout)
+    10.times do |i|
+      exchange.publish("Message ##{i}")
+    end
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      Coolio::Loop.default.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+end

data/examples/coolio_adapter/basic_publish.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Publish 100 messages using basic.publish" do |client|
+  puts "AMQP connection is open: #{client.connection.server_properties.inspect}"
+
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open!"
+  end
+
+  exchange = AMQ::Client::Exchange.new(client, channel, "amqclient.adapters.em.exchange1", :fanout)
+  exchange.declare do
+    100.times do
+      # exchange.publish("à bientôt!")
+      exchange.publish("See you soon!")
+    end
+
+    $stdout.flush
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      Coolio::Loop.default.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+end

data/examples/coolio_adapter/channel_close.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Open and then close AMQ channel" do |client|
+  puts "AMQP connection is open: #{client.connection.server_properties.inspect}"
+
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open!"
+    puts "Lets close it."
+    channel.close do
+      puts "Closed channel ##{channel.id}"
+      puts
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        Coolio::Loop.default.stop
+      end
+    end
+  end
+end