amqp 0.8.0.rc2 → 0.8.0.rc3

data/examples/error_handling/handling_authentication_failure_with_a_callback.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "bundler"
+Bundler.setup
+
+$:.unshift(File.expand_path("../../../lib", __FILE__))
+
+require 'amqp'
+
+
+puts "=> TCP connection failure handling with a callback"
+puts
+
+handler             = Proc.new { |settings| puts "Failed to connect, as expected"; EM.stop }
+connection_settings = {
+  :port     => 5672,
+  :vhost    => "/amq_client_testbed",
+  :user     => "amq_client_gem",
+  :password => "amq_client_gem_password_that_is_incorrect #{Time.now.to_i}",
+  :timeout        => 0.3,
+  :on_tcp_connection_failure => handler,
+  :on_possible_authentication_failure => Proc.new { |settings|
+                                            puts "Authentication failed, as expected, settings are: #{settings.inspect}"
+
+                                            EM.stop
+                                          }
+}
+
+
+AMQP.start(connection_settings) do |connection, open_ok|
+  raise "This should not be reachable"
+end

data/examples/error_handling/tcp_connection_failure_handling_with_a_rescue_block.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "bundler"
+Bundler.setup
+
+$:.unshift(File.expand_path("../../../lib", __FILE__))
+
+require 'amqp'
+
+
+puts "=> TCP connection failure handling with a rescue statement"
+puts
+
+connection_settings = {
+  :port     => 9689,
+  :vhost    => "/amq_client_testbed",
+  :user     => "amq_client_gem",
+  :password => "amq_client_gem_password",
+  :timeout        => 0.3
+}
+
+begin
+  AMQP.start(connection_settings) do |connection, open_ok|
+    raise "This should not be reachable"
+  end
+rescue AMQP::TCPConnectionFailed => e
+  puts "Caught AMQP::TCPConnectionFailed => TCP connection failed, as expected."
+end
+

data/examples/error_handling/tcp_connection_failure_with_a_callback.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "bundler"
+Bundler.setup
+
+$:.unshift(File.expand_path("../../../lib", __FILE__))
+
+require 'amqp'
+
+
+puts "=> TCP connection failure handling with a callback"
+puts
+
+handler             = Proc.new { |settings| puts "Failed to connect, as expected"; EM.stop }
+connection_settings = {
+  :port     => 9689,
+  :vhost    => "/amq_client_testbed",
+  :user     => "amq_client_gem",
+  :password => "amq_client_gem_password",
+  :timeout        => 0.3,
+  :on_tcp_connection_failure => handler
+}
+
+
+AMQP.start(connection_settings) do |connection, open_ok|
+  raise "This should not be reachable"
+end

data/examples/{various → exchanges}/declare_an_exchange_without_assignment.rb

@@ -32,10 +32,6 @@ AMQP.start(:host => 'localhost') do |connection|
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
 
-    # queue.purge :nowait => true
-
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }

data/examples/guides/getting_started/01_hello_world.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "rubygems"
+require "amqp"
+
+EventMachine.run do
+  connection = AMQP.connect(:host => '127.0.0.1')
+  puts "Connected to AMQP broker. Running #{AMQP::VERSION} version of the gem..."
+
+  channel  = AMQP::Channel.new(connection)
+  queue    = channel.queue("amqpgem.examples.helloworld", :auto_delete => true)
+  exchange = channel.direct("")
+
+  queue.subscribe do |payload|
+    puts "Received a message: #{payload}. Disconnecting..."
+
+    connection.close {
+      EM.stop { exit }
+    }
+  end
+
+  exchange.publish "Hello, world!", :routing_key => queue.name
+end

data/examples/guides/getting_started/02_hello_world_dslified.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "rubygems"
+require "amqp"
+
+EventMachine.run do
+  AMQP.connect(:host => '127.0.0.1') do |connection|
+    puts "Connected to AMQP broker. Running #{AMQP::VERSION} version of the gem..."
+
+    channel  = AMQP::Channel.new(connection)
+
+    channel.queue("amqpgem.examples.helloworld", :auto_delete => true).subscribe do |payload|
+      puts "Received a message: #{payload}. Disconnecting..."
+
+      connection.close {
+        EM.stop { exit }
+      }
+    end
+
+    channel.direct("").publish "Hello, world!", :routing_key => queue.name
+  end
+end

data/examples/guides/getting_started/03_babblr.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "rubygems"
+require "amqp"
+
+AMQP.start("amqp://dev.rabbitmq.com:5672/") do |connection|
+  channel  = AMQP::Channel.new(connection)
+  exchange = channel.fanout("nba.scores")
+
+  channel.queue("joe", :auto_delete => true).bind(exchange).subscribe do |payload|
+    puts "#{payload} => joe"
+  end
+
+  channel.queue("aaron", :auto_delete => true).bind(exchange).subscribe do |payload|
+    puts "#{payload} => aaron"
+  end
+
+  channel.queue("bob", :auto_delete => true).bind(exchange).subscribe do |payload|
+    puts "#{payload} => bob"
+  end
+
+  exchange.publish("BOS 101, NYK 89").publish("ORL 85, ALT 88")
+
+  # disconnect & exit after 1 second
+  EventMachine.add_timer(1) do
+    exchange.delete
+
+    connection.close {
+      EM.stop { exit }
+    }
+  end
+end

data/examples/guides/getting_started/04_weathr.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "rubygems"
+require "amqp"
+
+EventMachine.run do
+  AMQP.connect do |connection|
+    channel  = AMQP::Channel.new(connection)
+    exchange = channel.topic("pub/sub", :auto_delete => true)
+
+    # Subscribers.
+    channel.queue("", :exclusive => true) do |queue|
+      queue.bind(exchange, :routing_key => "americas.north.#").subscribe do |headers, payload|
+        puts "An update for North America: #{payload}, routing key is #{headers.routing_key}"
+      end
+    end
+    channel.queue("americas.south").bind(exchange, :routing_key => "americas.south.#").subscribe do |headers, payload|
+      puts "An update for South America: #{payload}, routing key is #{headers.routing_key}"
+    end
+    channel.queue("us.california").bind(exchange, :routing_key => "americas.north.us.ca.*").subscribe do |headers, payload|
+      puts "An update for US/California: #{payload}, routing key is #{headers.routing_key}"
+    end
+    channel.queue("us.tx.austin").bind(exchange, :routing_key => "#.tx.austin").subscribe do |headers, payload|
+      puts "An update for Austin, TX: #{payload}, routing key is #{headers.routing_key}"
+    end
+    channel.queue("it.rome").bind(exchange, :routing_key => "europe.italy.rome").subscribe do |headers, payload|
+      puts "An update for Rome, Italy: #{payload}, routing key is #{headers.routing_key}"
+    end
+    channel.queue("asia.hk").bind(exchange, :routing_key => "asia.southeast.hk.#").subscribe do |headers, payload|
+      puts "An update for Hong Kong: #{payload}, routing key is #{headers.routing_key}"
+    end
+
+    EM.add_timer(1) do
+      exchange.publish("San Diego update", :routing_key => "americas.north.us.ca.sandiego").
+        publish("Berkeley update",         :routing_key => "americas.north.us.ca.berkeley").
+        publish("San Francisco update",    :routing_key => "americas.north.us.ca.sanfrancisco").
+        publish("New York update",         :routing_key => "americas.north.us.ny.newyork").
+        publish("São Paolo update",        :routing_key => "americas.south.brazil.saopaolo").
+        publish("Hong Kong update",        :routing_key => "asia.southeast.hk.hongkong").
+        publish("Kyoto update",            :routing_key => "asia.southeast.japan.kyoto").
+        publish("Shanghai update",         :routing_key => "asia.southeast.prc.shanghai").
+        publish("Rome update",             :routing_key => "europe.italy.roma").
+        publish("Paris update",            :routing_key => "europe.france.paris")
+    end
+
+
+    show_stopper = Proc.new {
+      connection.close do
+        EM.stop
+      end
+    }
+
+    EM.add_timer(2, show_stopper)
+  end
+end

data/examples/hello_world.rb

@@ -9,21 +9,20 @@ $:.unshift(File.expand_path("../../lib", __FILE__))
 require 'amqp'
 
 EventMachine.run do
-  AMQP.connect(:host => 'localhost') do |connection|
-    puts "Connected to AMQP broker"
+  connection = AMQP.connect(:host => '127.0.0.1')
+  puts "Connected to AMQP broker. Running #{AMQP::VERSION} version of the gem..."
 
-    channel  = AMQP::Channel.new(connection)
-    queue    = channel.queue("amqpgem.examples.hello_world")
-    exchange = channel.default_exchange
+  channel  = AMQP::Channel.new(connection)
+  queue    = channel.queue("amqpgem.examples.hello_world", :auto_delete => true)
+  exchange = channel.direct("")
 
-    queue.subscribe do |payload|
-      puts "Received a message: #{payload}. Disconnecting..."
+  queue.subscribe do |payload|
+    puts "Received a message: #{payload}. Disconnecting..."
 
-      connection.close {
-        EM.stop { exit }
-      }
-    end
+    connection.close {
+      EM.stop { exit }
+    }
+  end
 
-    exchange.publish "Hello, world!", :routing_key => queue.name
-  end  
+  exchange.publish "Hello, world!", :routing_key => queue.name
 end

data/examples/hello_world_with_eventmachine_in_a_separate_thread.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "bundler"
+Bundler.setup
+
+$:.unshift(File.expand_path("../../lib", __FILE__))
+
+require 'amqp'
+
+t = Thread.new { EventMachine.run }
+if defined?(JRUBY_VERSION)
+  # on the JVM, event loop startup takes longer and .next_tick behavior
+  # seem to be a bit different. Blocking current thread for a moment helps.
+  sleep 0.5
+end
+
+EventMachine.next_tick {
+  connection = AMQP.connect(:host => '127.0.0.1')
+  puts "Connected to AMQP broker. Running #{AMQP::VERSION} version of the gem..."
+
+  channel  = AMQP::Channel.new(connection)
+  queue    = channel.queue("amqpgem.examples.hello_world", :auto_delete => true)
+  exchange = channel.direct("")
+
+  queue.subscribe do |payload|
+    puts "Received a message: #{payload}. Disconnecting..."
+
+    connection.close {
+      EM.stop { exit }
+    }
+  end
+
+  exchange.publish "Hello, world!", :routing_key => queue.name  
+}
+
+t.join

data/examples/{various → legacy}/pingpong.rb

@@ -38,8 +38,6 @@ AMQP.start(:host => 'localhost') do |connection|
 
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }

data/examples/{various → legacy}/primes.rb

@@ -46,8 +46,6 @@ AMQP.start(:host => 'localhost') do |connection|
 
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }

data/examples/{various → queues}/automatic_binding_for_default_direct_exchange.rb

@@ -41,6 +41,10 @@ AMQP.start(:host => 'localhost') do |connection|
 
 
   show_stopper = Proc.new do
+    queue1.delete
+    queue2.delete
+    queue3.delete
+
     $stdout.puts "Stopping..."
     connection.close {
       EM.stop { exit }

data/examples/{various → queues}/basic_get.rb

@@ -53,8 +53,6 @@ AMQP.start(:host => 'localhost') do |connection|
 
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }

data/examples/{various → queues}/declare_a_queue_without_assignment.rb

@@ -32,10 +32,6 @@ AMQP.start("amqp://guest:guest@dev.rabbitmq.com:5672/") do |connection, open_ok|
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
 
-    # queue.purge :nowait => true
-
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }

data/examples/queues/declare_and_bind_a_server_named_queue.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require "bundler"
+Bundler.setup
+
+$:.unshift(File.expand_path("../../../lib", __FILE__))
+
+require 'amqp'
+
+
+puts "=> Queue#initialize example that uses a block"
+puts
+AMQP.start("amqp://guest:guest@dev.rabbitmq.com:5672/") do |connection, open_ok|
+  AMQP::Channel.new do |channel, open_ok|
+    puts "Channel ##{channel.id} is now open!" if channel.open?
+
+    xchange = channel.fanout("amq.fanout", :nowait => true)
+    q = AMQP::Queue.new(channel, "", :auto_delete => true)
+
+
+    EM.add_timer(0.5) do
+      puts "Channel ##{channel.id} is still open!" if channel.open?
+      q.bind(xchange).subscribe do |header, payload|
+        puts "Got a payload: #{payload}"
+      end
+
+      EventMachine.add_timer(0.3) { xchange.publish("à bientôt!") }
+    end
+  end
+
+
+  show_stopper = Proc.new do
+    $stdout.puts "Stopping..."
+
+    connection.close {
+      EM.stop { exit }
+    }
+  end
+
+  Signal.trap "INT", show_stopper
+  EM.add_timer(2, show_stopper)
+end

data/examples/{various → queues}/queue_status.rb

@@ -19,12 +19,12 @@ puts "=> Queue#status example"
 puts
 AMQP.start(:host => 'localhost') do |connection|
   channel   = AMQP::Channel.new
-  
+
   queue_name = "amqpgem.integration.queue.status.queue"
-  
+
   exchange = channel.fanout("amqpgem.integration.queue.status.fanout", :auto_delete => true)
   queue    = channel.queue(queue_name, :auto_delete => true)
-  
+
   queue.bind(exchange) do
     puts "Bound #{exchange.name} => #{queue.name}"
   end
@@ -43,11 +43,6 @@ AMQP.start(:host => 'localhost') do |connection|
 
   show_stopper = Proc.new do
     $stdout.puts "Stopping..."
-
-    # queue.purge :nowait => true
-
-    # now change this to just EM.stop and it
-    # unbinds instantly
     connection.close {
       EM.stop { exit }
     }