amqp 1.0.4 → 1.1.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f4554e86bc490a5dd3f2f784c70832873ed368e
-  data.tar.gz: 80190eba660ef0ec09858e79ad12d0a5709e5f9f
+  metadata.gz: 01406174e5cb3d674733040989c60c3c8c0392b3
+  data.tar.gz: c01d64774da2210e3c9d4b1ba8f3f934b7174209
 SHA512:
-  metadata.gz: 0e5a30019a6648312dca81aaac924ebd3a8a156d8bcd32029ed599194b378670022f8f932d769feb3dba93799d162a1aad2843e8d79ce57ad3e054132d986486
-  data.tar.gz: 19061cf19243bcc120ecefb9ba68dc8e112f52f766b9e2e932647c6d98734fda345e9e60daa1a1586507cecaaa78d04a408004f8e14b312cc2a0c43e6db3c9fb
+  metadata.gz: 268b7dd0dba139086ad620543cc034c402e794461e7908308e5a748c205020a9d815be0461dc0fa768dccca2c633bfd954220bd768f086ab3b252220a4eaa4b2
+  data.tar.gz: 304a194b0860926c7318d8f89b64de2a1e6fe6317249cde8d521581e5e9009b95ca93c6d86671a5aa3035802153974531cd4d5e903f167741a9dc4f937bbb6b0

data/.gitignore

@@ -16,3 +16,4 @@ doc/*
 tmp/*
 bin/*
 .AppleDouble/*
+debug/*

data/.ruby-version

@@ -0,0 +1 @@
+2.0.0@rabbitmq

data/ChangeLog.md

@@ -0,0 +1,35 @@
+## Changes Between 1.0.0 and 1.1.0
+
+### AMQP::Channel#confirm_select is Now Delayed
+
+`AMQP::Channel#confirm_select` is now delayed until after the channel
+is opened, making it possible to use it with the pseudo-synchronous
+code style.
+
+### RabbitMQ Extensions are Now in Core
+
+amqp gem has been targeting RabbitMQ exclusively for a while now.
+
+RabbitMQ extensions are now loaded by default and will be even more
+tightly integrated in the future.
+
+### AMQP::Channel.default is Removed
+
+`AMQP::Channel.default` and method_missing-based operations on the default
+channel has been removed. They've been deprecated since 0.6.
+
+### AMQP::Channel#rpc is Removed
+
+`AMQP::RPC`-related code has been removed. It has been deprecated
+since 0.7.
+
+### AMQP::Channel.on_error is Removed
+
+Long time deprecated `AMQP::Channel.on_error` is removed.
+
+
+## Version 1.0.0
+
+### Deprecated APIs are Being Removed
+
+Most of public API bits deprecated in 0.8.0 are COMPLETELY REMOVED.

data/Gemfile

@@ -1,6 +1,6 @@
 # encoding: utf-8
 
-source :rubygems
+source "https://rubygems.org"
 
 # Use local clones if possible.
 # If you want to use your local copy, just symlink it to vendor.
@@ -14,7 +14,7 @@ def custom_gem(name, options = Hash.new)
   end
 end
 
-custom_gem "eventmachine"
+custom_gem "eventmachine", ">= 1.0.0"
 # gem "json", :platform => :ruby_18
 custom_gem "amq-client",   :git => "git://github.com/ruby-amqp/amq-client.git",   :branch => "master"
 custom_gem "amq-protocol", :git => "git://github.com/ruby-amqp/amq-protocol.git", :branch => "master"
@@ -32,13 +32,11 @@ group :development do
     gem "thin"
     gem "unicorn"
   end
-
-  gem "changelog"
 end
 
 group :test do
   gem "rspec", "~> 2.6.0"
-  gem "rake",  "~> 0.9.2"
+  gem "rake",  "~> 10.0.0"
 
   custom_gem "evented-spec", :git => "git://github.com/ruby-amqp/evented-spec.git", :branch => "master"
   gem "effin_utf8"

data/README.md

@@ -6,25 +6,20 @@ This library works with Ruby 1.8.7 (*except for p249*, see the FAQ), Ruby 1.9.2,
 0.8.0 and later versions of amqp gem implement [AMQP 0.9.1](http://www.rabbitmq.com/tutorials/amqp-concepts.html) (see also [AMQP 0.9.1 spec document](http://bit.ly/amqp091spec)) and support [RabbitMQ extensions to AMQP 0.9.1](http://www.rabbitmq.com/extensions.html).
 
 
-## I know what RabbitMQ is, how do I get started?
+## I know what AMQP is, how do I get started?
 
 See [Getting started with amqp gem](http://rubyamqp.info/articles/getting_started/) and other [amqp gem documentation guides](http://rubyamqp.info/).
-We recommend that you read [AMQP 0.9.1 Model Explained](http://www.rabbitmq.com/tutorials/amqp-concepts.html)
-and consider [Bunny](http://rubybunny.info) and [March Hare](http://rubymarchhare.info), too.
+We recommend that you read [AMQP 0.9.1 Model Explained](http://www.rabbitmq.com/tutorials/amqp-concepts.html), too.
 
 
 
-## What is AMQP 0.9.1?
+## What is AMQP?
 
-AMQP 0.9.1 is a messaging middleware protocol that emphasizes
-interoperability between different technologies (for example, Java,
-.NET, Ruby, Python, Node.js, Erlang, C and so on).
+AMQP is an [open standard for messaging middleware](http://www.amqp.org/confluence/display/AMQP/About+AMQP) that
+emphasizes interoperability between different technologies (for example, Java, .NET, Ruby, Python, Node.js, Erlang, C and so on).
 
-Key features of AMQP 0.9.1 are very flexible yet simple routing and binary
-protocol efficiency. AMQP 0.9.1 supports many sophisticated features, for
-example, message acknowledgements, returning of messages to producer,
-redelivery of messages that couldn't be processed, load balancing
-between message consumers and so on.
+Key features of AMQP are very flexible yet simple routing and binary protocol efficiency. AMQP supports many sophisticated features, for example,
+message acknowledgements, returning of messages to producer, redelivery of messages that couldn't be processed, load balancing between message consumers and so on.
 
 
 ## What is amqp gem good for?
@@ -183,14 +178,14 @@ We cover Web application integration for multiple Ruby Web servers in [Connectin
 
 ## Migration from amqp gem 0.6.x and 0.7.x
 
-Upgrading from amqp gem 0.6.x and 0.7.x to to 0.8.0.RCs is straightforward, please see [amqp gem 0.8.0 migration guide](http://rubyamqp.info/articles/08_migration/).
+Upgrading from amqp gem 0.6.x and 0.7.x to 0.8.0+ is straightforward, please see [amqp gem 0.8.0 migration guide](http://rubyamqp.info/articles/08_migration/).
 The same guide explains amqp gem versions history and why you would want to upgrade.
 
 
 
 ## Maintainer Information
 
-amqp gem is maintained by [Michael Klishin](https://github.com/michaelklishin).
+amqp gem is maintained by [Michael Klishin](http://twitter.com/michaelklishin).
 
 
 ## Continuous Integration

data/amqp.gemspec

@@ -24,8 +24,8 @@ Gem::Specification.new do |s|
 
   # Dependencies
   s.add_dependency "eventmachine"
-  s.add_dependency "amq-client",   "~> 1.0.3"
-  s.add_dependency "amq-protocol", ">= 1.9.0"
+  s.add_dependency "amq-client",   "~> 1.1.0.pre1"
+  s.add_dependency "amq-protocol", ">= 1.6.0"
 
   s.rubyforge_project = "amqp"
 end

data/lib/amqp/channel.rb

@@ -213,7 +213,6 @@ module AMQP
 
       super(@connection, id, options)
 
-      @rpcs                       = Hash.new
       # we need this deferrable to mimic what AMQP gem 0.7 does to enable
       # the following (pseudo-synchronous) style of programming some people use in their
       # existing codebases:
@@ -344,10 +343,6 @@ module AMQP
     #                                                    method it will raise a channel or connection exception.
     #
     #
-    # @raise [AMQP::Error] Raised when exchange is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when exchange is declared with  :passive => true and the exchange does not exist.
-    #
-    #
     # @example Using default pre-declared direct exchange and no callbacks (pseudo-synchronous style)
     #
     #    # an exchange application A will be using to publish updates
@@ -475,11 +470,6 @@ module AMQP
     #                                                    not wait for a reply method.  If the server could not complete the
     #                                                    method it will raise a channel or connection exception.
     #
-    #
-    # @raise [AMQP::Error] Raised when exchange is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when exchange is declared with  :passive => true and the exchange does not exist.
-    #
-    #
     # @example Using fanout exchange to deliver messages to multiple consumers
     #
     #   # open up a channel
@@ -540,11 +530,6 @@ module AMQP
     #                                                    not wait for a reply method.  If the server could not complete the
     #                                                    method it will raise a channel or connection exception.
     #
-    #
-    # @raise [AMQP::Error] Raised when exchange is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when exchange is declared with  :passive => true and the exchange does not exist.
-    #
-    #
     # @example Using topic exchange to deliver relevant news updates
     #   AMQP.connect do |connection|
     #     channel  = AMQP::Channel.new(connection)
@@ -656,10 +641,6 @@ module AMQP
     #                                                    method it will raise a channel or connection exception.
     #
     #
-    # @raise [AMQP::Error] Raised when exchange is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when exchange is declared with  :passive => true and the exchange does not exist.
-    #
-    #
     # @example Using headers exchange to route messages based on multiple attributes (OS, architecture, # of cores)
     #
     #   puts "=> Headers routing example"
@@ -801,12 +782,6 @@ module AMQP
     #                                                    not wait for a reply method.  If the server could not complete the
     #                                                    method it will raise a channel or connection exception.
     #
-    #
-    # @raise [AMQP::Error] Raised when queue is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when queue is declared with :passive => true and the queue does not exist.
-    # @raise [AMQP::Error] Raised when queue is declared with :exclusive => true and queue with that name already exist.
-    #
-    #
     # @yield [queue, declare_ok] Yields successfully declared queue instance and AMQP method (queue.declare-ok) instance. The latter is optional.
     # @yieldparam [Queue] queue Queue that is successfully declared and is ready to be used.
     # @yieldparam [AMQP::Protocol::Queue::DeclareOk] declare_ok AMQP queue.declare-ok) instance.
@@ -869,49 +844,6 @@ module AMQP
 
 
 
-    # Instantiates and returns an RPC instance associated with this channel.
-    #
-    # The optional object may be a class name, module name or object
-    # instance. When given a class or module name, the object is instantiated
-    # during this setup. The passed queue is automatically subscribed to so
-    # it passes all messages (and their arguments) to the object.
-    #
-    # Marshalling and unmarshalling the objects is handled internally. This
-    # marshalling is subject to the same restrictions as defined in the
-    # [http://ruby-doc.org/core/classes/Marshal.html Marshal module} in the Ruby standard
-    # library.
-    #
-    # When the optional object is not passed, the returned rpc reference is
-    # used to send messages and arguments to the queue. See {AMQP::RPC#method_missing}
-    # which does all of the heavy lifting with the proxy. Some client
-    # elsewhere must call this method *with* the optional block so that
-    # there is a valid destination. Failure to do so will just enqueue
-    # marshalled messages that are never consumed.
-    #
-    # @example Use of RPC
-    #
-    #   # TODO
-    #
-    #
-    # @param [String, Queue] Queue to be used by RPC server.
-    # @return [RPC]
-    # @api public
-    def rpc(name, obj = nil)
-      RPC.new(self, name, obj)
-    end
-
-
-
-    # Returns a hash of all rpc proxy objects.
-    #
-    # Most of the time, this method is not
-    # called by application code.
-    # @api plugin
-    def rpcs
-      @rpcs.values
-    end
-
-
 
     # @group Channel lifecycle
 
@@ -1092,20 +1024,18 @@ module AMQP
       super(&block)
     end
 
+    # @endgroup
 
-    # Defines a global callback to be run on channel-level exception across
-    # all channels. Consider using Channel#on_error instead. This method is here for sake
-    # of backwards compatibility with 0.6.x and 0.7.x releases.
-    # @see AMQP::Channel#on_error
-    # @deprecated
-    # @api public
-    def self.on_error(&block)
-      self.error(&block)
-    end # self.on_error(&block)
 
-    # @endgroup
+    # @group Publisher Confirms
 
+    def confirm_select(nowait = false, &block)
+      self.once_open do
+        super(nowait, &block)
+      end
+    end
 
+    # @endgroup
 
 
     #
@@ -1177,7 +1107,6 @@ module AMQP
     # @api plugin
     def reset_state!
       super
-      @rpcs = Hash.new
     end # reset_state!
 
 
@@ -1248,46 +1177,6 @@ module AMQP
       @int_allocator ||= IntAllocator.new(1, max_channel)
     end # self.initialize_channel_id_allocator
 
-    # @private
-    # @api plugin
-    def register_rpc(rpc)
-      raise ArgumentError, "argument is nil!" unless rpc
-
-      @rpcs[rpc.name] = rpc
-    end # register_rpc(rpc)
-
-    # @private
-    # @api plugin
-    def find_rpc(name)
-      @rpcs[name]
-    end
-
-
-    #
-    # Backwards compatibility with 0.6.x
-    #
-
-    # unique identifier of the default thread-local channel
-    # @deprecated
-    # @private
-    def self.id
-      Thread.current[:mq_id] ||= "#{`hostname`.strip}-#{Process.pid}-#{Thread.current.object_id}"
-    end
-
-    # @private
-    # @deprecated
-    def self.default
-      # TODO: clear this when connection is closed
-      Thread.current[:mq] ||= AMQP::Channel.new
-    end
-
-    # Allows for calls to all MQ instance methods. This implicitly calls
-    # AMQP::Channel.new so that a new channel is allocated for subsequent operations.
-    # @deprecated
-    def self.method_missing(meth, *args, &blk)
-      self.default.__send__(meth, *args, &blk)
-    end
-
 
     protected
 

data/lib/amqp/client.rb

@@ -39,9 +39,6 @@ module AMQP
                      AMQP.client.connect(opts.merge(options))
                    end
 
-      connection.on_open do
-        require "amqp/extensions/rabbitmq" if connection.broker.rabbitmq?
-      end
       connection
     end
 

data/lib/amqp/exchange.rb

@@ -50,7 +50,7 @@ module AMQP
   # As part of the standard, the server _must_ predeclare the direct exchange
   # 'amq.direct' and the fanout exchange 'amq.fanout' (all exchange names
   # starting with 'amq.' are reserved). Attempts to declare an exchange using
-  # 'amq.' as the name will raise an AMQP::Error and fail. In practice these
+  # 'amq.' as the name will result in a channel-level exception and fail. In practice these
   # default exchanges are never used directly by client code.
   #
   #
@@ -278,10 +278,6 @@ module AMQP
     # @option opts [Hash] :arguments (nil)  A hash of optional arguments with the declaration. Some brokers implement
     #                                          AMQP extensions using x-prefixed declaration arguments.
     #
-    #
-    # @raise [AMQP::Error] Raised when exchange is redeclared with parameters different from original declaration.
-    # @raise [AMQP::Error] Raised when exchange is declared with :passive => true and the exchange does not exist.
-    #
     # @yield [exchange, declare_ok] Yields successfully declared exchange instance and AMQP method (exchange.declare-ok) instance. The latter is optional.
     # @yieldparam [Exchange] exchange Exchange that is successfully declared and is ready to be used.
     # @yieldparam [AMQP::Protocol::Exchange::DeclareOk] declare_ok AMQP exchange.declare-ok) instance.

data/lib/amqp/extensions/rabbitmq.rb

@@ -1,3 +1,3 @@
 # encoding: utf-8
 
-require "amq/client/extensions/rabbitmq"
+# No-op as of 1.1

data/lib/amqp/version.rb

@@ -6,5 +6,5 @@ module AMQP
   #
   # @see AMQ::Protocol::VERSION
   # @return [String] AMQP gem version
-  VERSION = '1.0.4'
+  VERSION = '1.1.0.pre1'
 end

data/spec/integration/channel_level_exception_with_multiple_channels_spec.rb

@@ -35,13 +35,6 @@ describe AMQP do
       end
       @q1 = @channel.queue(name, options)
 
-      # backwards compatibility, please consider against
-      # using global error handlers in your programs!
-      AMQP::Channel.on_error do |msg|
-        puts "Global handler has fired: #{msg}"
-        @global_callback_fired = true
-      end
-
       # Small delays to ensure the order of execution
       delayed(0.1) {
         @other_channel = AMQP::Channel.new
@@ -58,7 +51,6 @@ describe AMQP do
 
       done(0.4) {
         @callback_fired.should be_true
-        @global_callback_fired.should be_true
         # looks like there is a difference between platforms/machines
         # so check either one. MK.
         @other_channel.closed?.should be_true

data/spec/integration/headers_exchange_routing_spec.rb

@@ -49,7 +49,7 @@ describe "Headers exchange" do
     end
 
     any_linux_messages = []
-    @channel.queue("", :auto_delete => true).bind(exchange, :arguments => { :os => 'linux' }).subscribe do |metadata, payload|
+    @channel.queue("", :auto_delete => true).bind(exchange, :arguments => { "x-match" => "any", :os => 'linux' }).subscribe do |metadata, payload|
       any_linux_messages << [metadata, payload]
     end
 
@@ -59,7 +59,7 @@ describe "Headers exchange" do
     end
 
     riak_messages = []
-    @channel.queue("", :auto_delete => true).bind(exchange, :arguments => { :package => { :name => 'riak', :version => '0.14.2' } }).subscribe do |metadata, payload|
+    @channel.queue("", :auto_delete => true).bind(exchange, :arguments => { "x-match" => "any", :package => { :name => 'riak', :version => '0.14.2' } }).subscribe do |metadata, payload|
       riak_messages << [metadata, payload]
     end
 
@@ -110,7 +110,7 @@ describe "Multiple consumers" do
       @queue    = @channel.queue("", :auto_delete => true)
       @exchange = @channel.headers("amqpgem.tests.integration.headers.exchange1", :auto_delete => true)
 
-      @queue.bind(@exchange, :arguments => { :slug => "all" })
+      @queue.bind(@exchange, :arguments => { :slug => "all", "x-match" => "any" })
     end
 
 

data/spec/integration/store_and_forward_spec.rb

@@ -47,7 +47,7 @@ describe "Store-and-forward routing" do
         expected_number_of_messages = 300
         # It is always a good idea to use non-ASCII charachters in
         # various test suites. MK.
-        dispatched_data             = "libertà è participazione (inviato a #{Time.now.to_i})"
+        dispatched_data             = "messages sent at #{Time.now.to_i}"
 
         @queue.purge
         @queue.subscribe(:ack => false) do |payload|
@@ -81,8 +81,8 @@ describe "Store-and-forward routing" do
           @exchange.publish(rand, :key => @queue_name)
         end
 
-        # 6 seconds are for Rubinius, it is surprisingly slow on this workload
-        done(6.0) {
+        # 5 seconds are for Rubinius, it is surprisingly slow on this workload
+        done(5.0) {
           number_of_received_messages.should == expected_number_of_messages
           @queue.unsubscribe
         }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amqp
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0.pre1
 platform: ruby
 authors:
 - Aman Gupta
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-21 00:00:00.000000000 Z
+date: 2013-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eventmachine
@@ -32,28 +32,28 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.1.0.pre1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.1.0.pre1
 - !ruby/object:Gem::Dependency
   name: amq-protocol
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.6.0
 description: Widely used, feature-rich asynchronous RabbitMQ client with batteries
   included.
 email:
@@ -84,9 +84,10 @@ extra_rdoc_files:
 files:
 - .gitignore
 - .rspec
+- .ruby-version
 - .travis.yml
 - .yardopts
-- CHANGELOG
+- ChangeLog.md
 - Gemfile
 - README.md
 - Rakefile
@@ -319,12 +320,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - '>'
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: amqp
-rubygems_version: 2.1.6
+rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: Widely used, feature-rich asynchronous RabbitMQ client with batteries included

data/CHANGELOG

@@ -1,101 +0,0 @@
-= Version 1.0.0
-
-  * [API] All public API bits deprecated in 0.8.0 are COMPLETELY REMOVED
-
-= Version 0.9.0 to 0.9.4
-
-  * [BUG] A couple of concurrency issues (race conditions) fixed for apps that actively close and/or reuse channels
-  * [BUG] AMQP::Queue#initialize with :nowait => true no longer fails with NoMethodError
-  * [FEATURE] Automatic recovery mode now works for publishers
-
-
-= Version 0.8.1
-
-  * [BUG] AMQP::Queue#status can no longer result in queue instance @ivars being changed.
-  * [API] AMQP::Channel#reuse allows channel instance to be reused with a different channel id, may be used to recover from channel-level exceptions.
-
-
-= Version 0.8.0
-
-  * [API] AMQP::Session#on_skipped_heartbeats callback that can be used to handle skipped heartbeats (for cases when TCP network failure detection is not timely enough)
-  * [API] AMQP::Exchange#publish calls now use a mutex on the channel exchange is declared on. Sharing channels between threads is discouraged but amqp gem covers your back in the most dangerous case.
-  * [API] AMQP::Channel#synchronize now can be used to guarantee mutual exclusion of multiple threads on channel instances.
-  * [BUG] Empty messages can finally be published fine. Yes, it took us just 3 years.
-  * [FEATURE] When connected to RabbitMQ, RabbitMQ-specific extensions are required automatically
-  * [FEATURE] AMQP::Session#broker and AMQP::Broker allow for broker capabilities inspection
-  * [FEATURE] New bitset-based channel id allocator
-  * [FEATURE] Multiple consumers per queue with AMQP::Consumer
-  * [FEATURE] Automatic recovery mode for channels
-  * [FEATURE] Network connection recovery callbacks for channels, exchanges, queues, consumers
-  * [API] Connection URI (string) format for vhosts no longer assumes that vhosts begin with a slash (/), learn more at http://bit.ly/mfzwcB
-  * [FEATURE] Returned messages, including header & content via AMQP::Exchange#on_publish. Callback accepts 3 args: basic_return, header, body
-  * [BUG] Ruby 1.8.7-p249 is not supported because of this (p249-specific) Ruby bug: http://bit.ly/iONBmH
-  * [FEATURE] AMQP::Utilities::EventLoopHelper detects app server (if any) being used and starts EventMachine reactor in an optimal way.
-  * [FEATURE] AMQP 0.9.1 support, including tx.* operations class.
-  * [API] Default authentication handler now raises AMQP::PossibleAuthenticationFailureError
-  * [API] AMQP::Channel#initialize now takes 3rd (optional) options hash.
-  * [API] Broker connection class is now AMQP::Session.
-  * [API] AMQP::Error instance now may carry cause, an exception that caused exception in question to be raised.
-  * [API] When initial TCP connection fails, default action is now to raise AMQP::TCPConnectionFailed.
-  * [API] AMQP::BasicClient#reconnect now takes 2nd optional argument, period of waiting in seconds.
-  * [FEATURE] Handlers for initial connection failure, connection loss; channel-level exceptions handlers on Channel instances.
-  * [API] AMQP::Exchange#initialize now accepts :arguments option that takes a hash.
-  * [API] AMQP::Queue#initialize now accepts :arguments option that takes a hash.
-  * [API] AMQP#Logger is deprecated. It will be removed before 1.0 release.
-  * [API] AMQP#fork is deprecated. It will be removed before 1.0 release.
-  * [API] AMQP::RPC is deprecated. It will be removed before 1.0 release.
-  * [FEATURE] Significant improvements to the documentation. From now on lack of/poor documentation is considered a severe bug.
-  * [FEATURE] Support for RabbitMQ extensions to AMQP 0.9.1
-  * [API] AMQP::Exchange#publish now accepts (an optional) callback.
-  * [API] AMQP::Channel.new now accepts (an optional) callback.
-  * [API] AMQP::Header#ack now can acknowledge multiple deliveries
-  * [API] AMQP::Exchange#delete now takes (an optional) block that is called when exchange.delete-ok response arrives.
-  * [API] AMQP::Header now implements #to_hash
-  * [API] AMQP::Queue#pop block now can take 1, 2 or 3 arguments.
-  * [API] AMQP::Queue#purge  now takes an optional block which is called when queue.purge-ok response arrives.
-  * [API] AMQP::Queue#delete now takes an optional block which is called when queue.delete-ok response arrives.
-  * [API] AMQP::Queue#delete now accepts :nowait option.
-  * [API] AMQP::Queue#unbind now takes an optional block which is called when queue.unbind-ok response arrives.
-  * [API] AMQP::Queue#unbind now accepts :routing_key as alias to :key. we believe it is a good idea to use AMQP terms.
-  * [API] AMQP::Channel#prefetch now takes (an optional) 2nd parameter that specifies that QoS settings should be applied to underlying connection, as well as optional callback.
-  * [API] AMQP::Channel#recover now takes (an optional) callback that is called when basic.recover-ok is received.
-  * [API] AMQP::Frame is gone.
-  * [API] AMQP::Buffer is gone. Serialization & framing are now handled primarily by amq-protocol.
-  * [API] AMQP::Queue#publish is deprecated.
-  * [API] Name argument for AMQP::Queue.new and Channel#queue is optional.
-
-= Version 0.7.1
-
-  * [BUG] AMQP gem no longer conflicts with Builder 2.1.2 on Ruby 1.9.
-        All Ruby on Rails 3 users who run Ruby 1.9 are highly recommended
-                        to upgrade!
-  * [API] AMQP::Exchange.default no longer caches exchange object between calls
-          because it may lead to very obscure issues when channel that exchange was
-          using is closed (due to connection loss, as part of test suite teardown
-          or in any other way).
-
-  * [API] AMQP::Exchange.default now accepts channel as a parameter.
-  * [API] AMQP::Exchange#channel
-  * [BUG] Basic.Return is not supported by amqp gem yet, but it should not result in obscure exceptions
-  * [API] AMQP::Exchange#publish now supports content type overriding.
-  * [API] Introduce AMQP::Exchange #durable?, #transient?, #auto_deleted? and #passive?
-  * [API] Introduce AMQP::Channel#open?
-  * [BUG] AMQP connection was considered established prematurely.
-  * [API] MQ.logging is removed; please use AMQP.logging from now on.
-  * [API] MQ::Queue class is deprecated; please use AMQP::Queue from now on.
-  * [API] MQ::Exchange class is deprecated; please use AMQP::Exchange from now on.
-  * [API] MQ class is deprecated; please use AMQP::Channel from now on.
-  * [API] require "mq" is deprecated; please use require "amqp" from now on.
-
-
-= Version 0.7
-  * [BUG] Sync API for queues and exchanges, support for server-generated queues & exchange names (via semi-lazy collection).
-  * [BUG] Sync API for MQ#close (Channel.Close) [issue #34].
-  * [FEATURE] AMQP URL from majek's fork, with some fixes. Example: AMQP.start("amqps://")
-  * [DEVELOP] Added some em-spec-based specs, bin/irb, Gemfile.
-  * [FEATURE] Added MQ::Exchange.default for the default exchange.
-  * [FEATURE] Raise an exception if we're trying to use Basic.Reject with RabbitMQ.
-  * [FEATURE] Fail if an entity is re-declared with different options.
-  * [BUG] Don't reconnect if the credentials are wrong.
-  * [BUG] Fixed an exception which occurred when Queue#bind was called synchronously with a callback.
-  * [DEVELOPMENT] Added a lot of specs (Bacon replaced by rSpec 2).