amq-client 0.5.0

data/examples/eventmachine_adapter/basic_consume_with_rejections.rb

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Reject a message using basic.reject" 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 |method, header, payload|
+      puts "Got a delivery: #{payload} (delivery tag: #{method.delivery_tag}), rejecting..."
+
+      queue.reject(method.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"
+      EM.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+
+  EM.add_timer(1, show_stopper)
+end

data/examples/eventmachine_adapter/basic_get.rb

@@ -0,0 +1,57 @@
+#!/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
+
+  exchange = AMQ::Client::Exchange.new(client, channel, "amq.fanout", :fanout)
+  30.times do |i|
+    puts "Publishing message ##{i}"
+    exchange.publish("Message ##{i}")
+  end
+  sleep 0.1
+
+  30.times do |i|
+    queue.get(true) do |method, header, payload|
+      puts "basic.get callback has fired"
+      puts
+      puts " => Payload is #{payload}"
+      puts " => header is #{header.decode_payload.inspect}"
+      puts " => delivery_tag is #{method.delivery_tag}"
+      puts " => redelivered is #{method.redelivered}"
+      puts " => exchange is #{method.exchange}"
+      puts " => routing_key is #{method.routing_key}"
+      puts " => message_count is #{method.message_count}"
+      puts
+      puts
+    end
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      EM.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+
+  EM.add_timer(1, show_stopper)
+end

data/examples/eventmachine_adapter/basic_get_with_empty_queue.rb

@@ -0,0 +1,53 @@
+#!/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
+  sleep 0.1
+
+  10.times do |i|
+    queue.get(true) do |method, header, payload|
+      puts "basic.get callback has fired"
+      puts
+      puts "Payload is #{payload}"
+      if header
+        puts "header is #{header.decode_payload.inspect}"
+      else
+        puts "header is nil"
+      end
+      puts "delivery_tag is #{method.delivery_tag.inspect}"
+      puts "redelivered is #{method.redelivered.inspect}"
+      puts "exchange is #{method.exchange.inspect}"
+      puts "routing_key is #{method.routing_key.inspect}"
+      puts "message_count is #{method.message_count.inspect}"
+    end
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      EM.stop
+    end
+  }
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+
+  EM.add_timer(1, show_stopper)
+end

data/examples/eventmachine_adapter/basic_publish.rb

@@ -0,0 +1,38 @@
+#!/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!")
+      print "."
+    end
+
+    $stdout.flush
+  end
+
+  show_stopper = Proc.new {
+    client.disconnect do
+      puts
+      puts "AMQP connection is now properly closed"
+      EM.stop
+    end
+  }
+
+  EM.add_periodic_timer(1, show_stopper)
+
+  Signal.trap "INT",  show_stopper
+  Signal.trap "TERM", show_stopper
+end

data/examples/eventmachine_adapter/basic_qos.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Alter prefetching settings using basic.qos" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    AMQ::Client::Queue.new(client, channel).declare(false, false, false, true) do |q, _, _, _|
+      channel.qos do |_|
+        puts "basic.qos callback has fired"
+      end
+    end
+
+    show_stopper = Proc.new {
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        EM.stop
+      end
+    }
+
+    Signal.trap "INT",  show_stopper
+    Signal.trap "TERM", show_stopper
+
+    EM.add_timer(1, show_stopper)
+  end
+end

data/examples/eventmachine_adapter/basic_recover.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Notify broker about consumer recovery using basic.recover" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    AMQ::Client::Queue.new(client, channel).declare(false, false, false, true) do |q, _, _, _|
+      channel.recover do |_|
+        puts "basic.recover callback has fired"
+      end
+    end
+
+    show_stopper = Proc.new {
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        EM.stop
+      end
+    }
+
+    Signal.trap "INT",  show_stopper
+    Signal.trap "TERM", show_stopper
+
+    EM.add_timer(1, show_stopper)
+  end
+end

data/examples/eventmachine_adapter/basic_return.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "basic.return example" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    queue = AMQ::Client::Queue.new(client, channel).declare(false, false, false, true)
+
+    exchange = AMQ::Client::Exchange.new(client, channel, "amq.fanout", :fanout)
+    exchange.on_return do |method|
+      puts "Handling a returned message: exchange = #{method.exchange}, reply_code = #{method.reply_code}, reply_text = #{method.reply_text}"
+    end
+
+    10.times do |i|
+      exchange.publish("Message ##{i}", AMQ::Protocol::EMPTY_STRING, {}, false, true)
+    end
+
+    show_stopper = Proc.new {
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        EM.stop
+      end
+    }
+
+    Signal.trap "INT",  show_stopper
+    Signal.trap "TERM", show_stopper
+
+    EM.add_timer(1, show_stopper)
+  end
+end

data/examples/eventmachine_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"
+        EM.stop
+      end
+    end
+  end
+end

data/examples/eventmachine_adapter/channel_flow.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Activate or deactivate channel delivery using channel.flow" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    AMQ::Client::Queue.new(client, channel).declare(false, false, false, true) do |q, _, _, _|
+      puts "flow is now #{channel.flow_is_active? ? 'on' : 'off'}"
+
+      channel.flow(false) do |method|
+        puts "flow is now #{method.active ? 'on' : 'off'}"
+      end
+
+      sleep 0.1
+      channel.flow(true) do |method|
+        puts "flow is now #{method.active ? 'on' : 'off'}"
+      end
+    end
+
+    show_stopper = Proc.new {
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        EM.stop
+      end
+    }
+
+    Signal.trap "INT",  show_stopper
+    Signal.trap "TERM", show_stopper
+
+    EM.add_timer(1, show_stopper)
+  end
+end

data/examples/eventmachine_adapter/channel_level_exception_handling.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+__dir = File.dirname(File.expand_path(__FILE__))
+require File.join(__dir, "example_helper")
+
+amq_client_example "Channel-level exception handling" do |client|
+  channel = AMQ::Client::Channel.new(client, 1)
+  channel.open do
+    puts "Channel #{channel.id} is now open"
+
+    show_stopper = Proc.new {
+      client.disconnect do
+        puts
+        puts "AMQP connection is now properly closed"
+        EM.stop
+      end
+    }
+
+
+
+    channel.on_error do
+      puts "Oops, there is a channel-levle exceptions!"
+
+      EM.add_timer(1.2) { show_stopper.call }
+    end
+
+    # amq.* names are reserevd so this causes a channel-level exception. MK.
+    x = AMQ::Client::Exchange.new(client, channel, "amq.client.examples.extensions.x1", :direct)
+    x.declare(false, false, false, true, false)
+
+
+    EM.add_timer(1) do
+      if channel.closed?
+        puts "1 second later channel #{channel.id} is closed"
+      end
+    end
+
+    Signal.trap "INT",  show_stopper
+    Signal.trap "TERM", show_stopper
+
+    EM.add_timer(2, show_stopper)
+  end
+end

data/examples/eventmachine_adapter/example_helper.rb

@@ -0,0 +1,39 @@
+require "bundler"
+
+Bundler.setup
+Bundler.require(:default)
+
+$LOAD_PATH.unshift(File.expand_path("../../../lib", __FILE__))
+
+require "amq/client/adapters/event_machine"
+require "amq/client/queue"
+require "amq/client/exchange"
+
+
+if RUBY_VERSION.to_s =~ /^1.9/
+  Encoding.default_internal = Encoding::UTF_8
+  Encoding.default_external = Encoding::UTF_8
+end
+
+
+def amq_client_example(description = "", &block)
+  EM.run do
+    AMQ::Client::EventMachineClient.connect(:port => 5672, :vhost => "/amq_client_testbed", :frame_max => 65536, :heartbeat_interval => 1) do |client|
+      begin
+        puts
+        puts
+        puts "=============> #{description}"
+
+        block.call(client)
+      rescue Interrupt
+        warn "Manually interrupted, terminating ..."
+      rescue Exception => exception
+        STDERR.puts "\n\e[1;31m[#{exception.class}] #{exception.message}\e[0m"
+        exception.backtrace.each do |line|
+          line = "\e[0;36m#{line}\e[0m" if line.match(Regexp::quote(File.basename(__FILE__)))
+          STDERR.puts "  - " + line
+        end
+      end
+    end
+  end
+end