amq-client 0.7.0.alpha29 → 0.7.0.alpha30

data/lib/amq/client/adapters/event_machine.rb

@@ -33,7 +33,7 @@ module AMQ
       # @option settings [String] :broker (nil) Broker name (use if you intend to use broker-specific features).
       # @option settings [Fixnum] :frame_max (131072) Maximum frame size to use. If broker cannot support frames this large, broker's maximum value will be used instead.
       #
-      # @params [Hash] settings
+      # @param [Hash] settings
       def self.connect(settings = {}, &block)
         @settings = Settings.configure(settings)
 

data/lib/amq/client/channel.rb

@@ -87,6 +87,9 @@ module AMQ
         @connection
       end # connection
 
+
+      # @group Channel lifecycle
+
       # Opens AMQP channel.
       #
       # @api public
@@ -107,6 +110,11 @@ module AMQ
         self.redefine_callback :close, &block
       end
 
+      # @endgroup
+
+
+
+      # @group Message acknowledgements
 
       # Acknowledge one or all messages on the channel.
       #
@@ -128,18 +136,6 @@ module AMQ
         self
       end # reject(delivery_tag, requeue = true)
 
-      # Requests a specific quality of service. The QoS can be specified for the current channel
-      # or for all channels on the connection.
-      #
-      # @note RabbitMQ as of 2.3.1 does not support prefetch_size.
-      # @api public
-      def qos(prefetch_size = 0, prefetch_count = 32, global = false, &block)
-        @connection.send_frame(Protocol::Basic::Qos.encode(@id, prefetch_size, prefetch_count, global))
-
-        self.redefine_callback :qos, &block
-        self
-      end # qos(prefetch_size = 4096, prefetch_count = 32, global = false, &block)
-
       # Notifies AMQ broker that consumer has recovered and unacknowledged messages need
       # to be redelivered.
       #
@@ -155,13 +151,31 @@ module AMQ
         self
       end # recover(requeue = false, &block)
 
+      # @endgroup
+
+
+
+      # @group QoS and flow handling
+
+      # Requests a specific quality of service. The QoS can be specified for the current channel
+      # or for all channels on the connection.
+      #
+      # @note RabbitMQ as of 2.3.1 does not support prefetch_size.
+      # @api public
+      def qos(prefetch_size = 0, prefetch_count = 32, global = false, &block)
+        @connection.send_frame(Protocol::Basic::Qos.encode(@id, prefetch_size, prefetch_count, global))
+
+        self.redefine_callback :qos, &block
+        self
+      end # qos(prefetch_size = 4096, prefetch_count = 32, global = false, &block)
+
       # Asks the peer to pause or restart the flow of content data sent to a consumer.
       # This is a simple flow­control mechanism that a peer can use to avoid overflowing its
       # queues or otherwise finding itself receiving more messages than it can process. Note that
       # this method is not intended for window control. It does not affect contents returned to
       # Queue#get callers.
       #
-      # @param [Boolean] Desired flow state.
+      # @param [Boolean] active Desired flow state.
       #
       # @see http://bit.ly/htCzCX AMQP 0.9.1 protocol documentation (Section 1.5.2.3.)
       # @api public
@@ -172,6 +186,18 @@ module AMQ
         self
       end # flow(active = false, &block)
 
+      # @return [Boolean]  True if flow in this channel is active (messages will be delivered to consumers that use this channel).
+      #
+      # @api public
+      def flow_is_active?
+        @flow_is_active
+      end # flow_is_active?
+
+      # @endgroup
+
+
+
+      # @group Transactions
 
       # Sets the channel to use standard transactions. One must use this method at least
       # once on a channel before using #tx_tommit or tx_rollback methods.
@@ -204,12 +230,11 @@ module AMQ
         self
       end # tx_rollback(&block)
 
-      # @return [Boolean]  True if flow in this channel is active (messages will be delivered to consumers that use this channel).
-      #
-      # @api public
-      def flow_is_active?
-        @flow_is_active
-      end # flow_is_active?
+      # @endgroup
+
+
+
+      # @group Error handling
 
       # Defines a callback that will be executed when channel is closed after
       # channel-level exception.
@@ -219,6 +244,8 @@ module AMQ
         self.define_callback(:error, &block)
       end
 
+      # @endgroup
+
 
       #
       # Implementation
@@ -230,6 +257,12 @@ module AMQ
         @exchanges[exchange.name] = exchange
       end # register_exchange(exchange)
 
+      # Finds exchange in the exchanges cache on this channel by name. Exchange only exists in the cache if
+      # it was previously instantiated on this channel.
+      #
+      # @param [String] name Exchange name
+      # @return [AMQ::Client::Exchange] Exchange (if found)
+      # @api plugin
       def find_exchange(name)
         @exchanges[name]
       end

data/lib/amq/client/extensions/rabbitmq/basic.rb

@@ -16,7 +16,7 @@ module AMQ
             # @see http://www.rabbitmq.com/amqp-0-9-1-quickref.html#basic.nack
             def reject(delivery_tag, requeue = true, multi = false)
               if multi
-                @client.send_frame(Protocol::Basic::Nack.encode(self.id, delivery_tag, multi, requeue))
+                @connection.send_frame(Protocol::Basic::Nack.encode(self.id, delivery_tag, multi, requeue))
               else
                 super(delivery_tag, requeue)
               end
@@ -28,8 +28,8 @@ module AMQ
     end # Extensions
 
     class Channel
-      # use modules, a native Ruby way of extension of existing classes,
-      # instead of reckless monkey-patching. MK.      
+      # use modules, the native Ruby way of extension of existing classes,
+      # instead of reckless monkey-patching. MK.
       include Extensions::RabbitMQ::Basic::ChannelMixin
     end
   end # Client

data/lib/amq/client/extensions/rabbitmq/confirm.rb

@@ -104,7 +104,7 @@ module AMQ
 
               @uses_publisher_confirmations = true
               self.redefine_callback(:confirm_select, &block)
-              @client.send_frame(Protocol::Confirm::Select.encode(@id, nowait))
+              @connection.send_frame(Protocol::Confirm::Select.encode(@id, nowait))
 
               self
             end
@@ -190,21 +190,21 @@ module AMQ
 
 
             def self.included(host)
-              host.handle(Protocol::Confirm::SelectOk) do |client, frame|
+              host.handle(Protocol::Confirm::SelectOk) do |connection, frame|
                 method  = frame.decode_payload
-                channel = client.connection.channels[frame.channel]
+                channel = connection.channels[frame.channel]
                 channel.handle_select_ok(method)
               end
 
-              host.handle(Protocol::Basic::Ack) do |client, frame|
+              host.handle(Protocol::Basic::Ack) do |connection, frame|
                 method  = frame.decode_payload
-                channel = client.connection.channels[frame.channel]
+                channel = connection.channels[frame.channel]
                 channel.handle_basic_ack(method)
               end
 
-              host.handle(Protocol::Basic::Nack) do |client, frame|
+              host.handle(Protocol::Basic::Nack) do |connection, frame|
                 method  = frame.decode_payload
-                channel = client.connection.channels[frame.channel]
+                channel = connection.channels[frame.channel]
                 channel.handle_basic_nack(method)
               end
             end # self.included(host)

data/lib/amq/client/version.rb

@@ -1,5 +1,5 @@
 module AMQ
   module Client
-    VERSION = "0.7.0.alpha29"
+    VERSION = "0.7.0.alpha30"
   end
 end

metadata

@@ -1,17 +1,10 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: amq-client
-version: !ruby/object:Gem::Version 
-  hash: -3702664426
+version: !ruby/object:Gem::Version
+  version: 0.7.0.alpha30
   prerelease: 6
-  segments: 
-  - 0
-  - 7
-  - 0
-  - alpha
-  - 29
-  version: 0.7.0.alpha29
 platform: ruby
-authors: 
+authors:
 - Jakub Stastny
 - Michael S. Klishin
 - Theo Hultberg
@@ -19,50 +12,40 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-05-26 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-05-29 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: eventmachine
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2168548660 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: amq-protocol
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *2168548660
+- !ruby/object:Gem::Dependency
+  name: amq-protocol
+  requirement: &2168548020 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: -3702664412
-        segments: 
-        - 0
-        - 7
-        - 0
-        - alpha
-        - 4
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.7.0.alpha4
   type: :runtime
-  version_requirements: *id002
-description: 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
-email: 
+  prerelease: false
+  version_requirements: *2168548020
+description: 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
+email:
 - stastny@101ideas.cz
 - michael@novemberain.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.textile
 - doc/_index.html
 - doc/AMQ.html
@@ -73,7 +56,7 @@ extra_rdoc_files:
 - doc/index.html
 - doc/method_list.html
 - doc/top-level-namespace.html
-files: 
+files:
 - .gitignore
 - .gitmodules
 - .rspec
@@ -226,38 +209,26 @@ files:
 - doc/top-level-namespace.html
 homepage: http://github.com/ruby-amqp/amq-client
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      hash: 25
-      segments: 
-      - 1
-      - 3
-      - 1
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-
 rubyforge_project: amq-client
 rubygems_version: 1.8.4
 signing_key: 
 specification_version: 3
 summary: amq-client is a fully-featured, low-level AMQP 0.9.1 client
 test_files: []
-