bunny 0.2.0 → 0.3.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Chris Duncan
+ 
+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

@@ -0,0 +1,49 @@
+= Bunny: A synchronous Ruby AMQP client
+
+*GitHub* *repo*: http://github.com/celldee/bunny
+     
+=== DESCRIPTION:
+
+Bunny is an AMQP[http://www.amqp.org] (Advanced Message Queuing Protocol) client, written in Ruby, that is intended to allow you to interact with AMQP-compliant message brokers/servers such as RabbitMQ[http://www.rabbitmq.com] in a synchronous fashion.
+
+It is based on a great deal of useful code from amqp[http://github.com/tmm1/amqp] by Aman Gupta and Carrot[http://github.com/famoseagle/carrot] by Amos Elliston.
+
+You can use Bunny to -
+
+* Create and delete exchanges
+* Create and delete queues
+* Publish and consume messages
+
+Bunny is known to work with RabbitMQ version 1.5.4 and version 0-8 of the AMQP specification.
+
+=== INSTALL:
+
+*Rubyforge*: <tt>gem install bunny</tt>
+
+*GitHub*: <tt>gem install celldee-bunny</tt>
+
+=== QUICK START:
+
+   require 'bunny'
+
+   b = Bunny::Client.new(:logging => true)
+
+   # start a communication session with the amqp server
+   b.start
+
+   # declare a queue
+   q = b.queue('test1')
+
+   # publish a message to the queue
+   q.publish('Hello everybody!')
+
+   # get message from the queue
+   msg = q.pop
+
+   puts 'This is the message: ' + msg + "\n\n"
+
+   # close the connection
+   b.stop
+
+=== OTHER:
+Please see the _examples_ directory for additional usage information.

data/Rakefile

@@ -1,6 +1,6 @@
 task :codegen do
-  sh 'ruby protocol/codegen.rb > lib/amqp/spec.rb'
-	sh 'ruby lib/amqp/spec.rb'
+  sh 'ruby ext/codegen.rb > lib/bunny/protocol/spec.rb'
+	sh 'ruby lib/bunny/protocol/spec.rb'
 end
 
 task :spec do
@@ -8,5 +8,4 @@ task :spec do
 	Spec::Rake::SpecTask.new do |t|
 		t.spec_opts = ['--color']
 	end
-end
-	
+end

data/bunny.gemspec

@@ -0,0 +1,37 @@
+Gem::Specification.new do |s|
+  s.name = %q{bunny}
+  s.version = "0.3.0"
+  s.authors = ["Chris Duncan"]
+  s.date = %q{2009-05-10}
+  s.description = %q{Another synchronous Ruby AMQP client}
+  s.email = %q{celldee@gmail.com}
+  s.rubyforge_project = %q{bunny-amqp}
+  s.has_rdoc = true
+ 	s.extra_rdoc_files = [ "README" ]
+  s.rdoc_options = [ "--main", "README" ]
+  s.homepage = %q{http://github.com/celldee/bunny}
+  s.summary = %q{A synchronous Ruby AMQP client that enables interaction with AMQP-compliant brokers/servers.}
+  s.files = ["LICENSE",
+ "README",
+ "Rakefile",
+ "bunny.gemspec",
+ "examples/simple.rb",
+ "examples/simple_ack.rb",
+ "examples/simple_consumer.rb",
+ "examples/simple_fanout.rb",
+ "examples/simple_publisher.rb",
+ "examples/simple_topic.rb",
+ "ext/amqp-0.8.json",
+ "ext/codegen.rb",
+ "lib/bunny.rb",
+ "lib/bunny/client.rb",
+ "lib/bunny/exchange.rb",
+ "lib/bunny/protocol/protocol.rb",
+ "lib/bunny/protocol/spec.rb",
+ "lib/bunny/queue.rb",
+ "lib/bunny/transport/buffer.rb",
+ "lib/bunny/transport/frame.rb",
+ "spec/bunny_spec.rb",
+ "spec/exchange_spec.rb",
+ "spec/queue_spec.rb"]
+end

data/examples/simple.rb

@@ -10,7 +10,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new(:logging => true)
+b = Bunny::Client.new(:logging => true)
 
 # start a communication session with the amqp server
 b.start

data/examples/simple_ack.rb

@@ -10,7 +10,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new(:logging => true)
+b = Bunny::Client.new(:logging => true)
 
 # start a communication session with the amqp server
 b.start

data/examples/simple_consumer.rb

@@ -27,7 +27,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new(:logging => true)
+b = Bunny::Client.new(:logging => true)
 
 # start a communication session with the amqp server
 b.start

data/examples/simple_fanout.rb

@@ -10,7 +10,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new(:logging => true)
+b = Bunny::Client.new(:logging => true)
 
 # start a communication session with the amqp server
 b.start

data/examples/simple_publisher.rb

@@ -12,7 +12,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new(:logging => true)
+b = Bunny::Client.new(:logging => true)
 
 # start a communication session with the amqp server
 b.start

data/examples/simple_topic.rb

@@ -10,7 +10,7 @@ $:.unshift File.dirname(__FILE__) + '/../lib'
 
 require 'bunny'
 
-b = Bunny.new
+b = Bunny::Client.new
 
 # start a communication session with the amqp server
 b.start
@@ -50,9 +50,9 @@ msg = rugby.pop
 puts 'This is a message from the rugby q: ' + msg + "\n\n"
 
 # allsport queue got all of the messages
-until msg == 'QUEUE EMPTY' do
+until msg == :queue_empty do
 	msg = allsport.pop
-	puts 'This is a message from the allsport q: ' + msg + "\n\n" unless msg == 'QUEUE EMPTY'
+	puts 'This is a message from the allsport q: ' + msg + "\n\n" unless msg == :queue_empty
 end
 
 # close the client connection

data/ext/codegen.rb

@@ -0,0 +1,177 @@
+require 'rubygems'
+require 'json'
+
+name = 'amqp-0.8.json'
+path = File.dirname(__FILE__)+'/'+name
+s = JSON.parse(File.read(path))
+
+# require 'pp'
+# pp(s)
+# exit
+
+require 'erb'
+
+puts ERB.new(%q[
+  #:stopdoc:
+  # this file was autogenerated on <%= Time.now.to_s %>
+  # using <%= name.ljust(16) %> (mtime: <%= File.mtime(path) %>)
+  #
+  # DO NOT EDIT! (edit ext/codegen.rb instead, and run `rake codegen`)
+
+  module Bunny
+    module Transport
+      class Frame
+        def self.types
+          @types ||= {}
+        end
+
+        def self.Frame id
+          (@_base_frames ||= {})[id] ||= Class.new(Frame) do
+            class_eval %[
+              def self.inherited klass
+                klass.const_set(:ID, #{id})
+                Frame.types[#{id}] = klass
+              end
+            ]
+          end
+        end
+
+        <%- s['constants'].select{|c| (1..8).include? c['value'] }.each do |c| -%>
+        class <%= c['name'].gsub(/^FRAME-/,'').split('-').map{|w| w.downcase.capitalize}.join.ljust(9) -%> < Frame( <%= c['value'] -%> ); end
+        <%- end -%>
+
+        FOOTER = <%= frame_end = s['constants'].find{|c| c['name'] == 'FRAME-END' }['value'] %>
+      end
+    end
+  end
+  
+  module Bunny
+    module Protocol
+      HEADER        = <%= s['name'].dump %>.freeze
+      VERSION_MAJOR = <%= s['major-version'] %>
+      VERSION_MINOR = <%= s['minor-version'] %>
+      PORT          = <%= s['port'] %>
+
+      RESPONSES = {
+        <%- s['constants'].select{|c| c['value'] != frame_end and (200..500).include? c['value'] }.each do |c| -%>
+        <%= c['value'] %> => :<%= c['name'].tr('-', '_').gsub(/^FRAME_/,'').upcase -%>,
+        <%- end -%>
+      }
+
+      FIELDS = [
+        <%- s['domains'].select{|d| d.first == d.last }.each do |d| -%>
+        :<%= d.first -%>,
+        <%- end -%>
+      ]
+
+      class Class
+        class << self
+          FIELDS.each do |f|
+            class_eval %[
+              def #{f} name
+                properties << [ :#{f}, name ] unless properties.include?([:#{f}, name])
+                attr_accessor name
+              end
+            ]
+          end
+        
+          def properties() @properties ||= [] end
+
+          def id()   self::ID end
+          def name() self::NAME end
+        end
+
+        class Method
+          class << self
+            FIELDS.each do |f|
+              class_eval %[
+                def #{f} name
+                  arguments << [ :#{f}, name ] unless arguments.include?([:#{f}, name])
+                  attr_accessor name
+                end
+              ]
+            end
+          
+            def arguments() @arguments ||= [] end
+
+            def parent() Protocol.const_get(self.to_s[/Protocol::(.+?)::/,1]) end
+            def id()     self::ID end
+            def name()   self::NAME end
+          end
+
+          def == b
+            self.class.arguments.inject(true) do |eql, (type, name)|
+              eql and __send__("#{name}") == b.__send__("#{name}")
+            end
+          end
+        end
+    
+        def self.methods() @methods ||= {} end
+    
+        def self.Method(id, name)
+          @_base_methods ||= {}
+          @_base_methods[id] ||= ::Class.new(Method) do
+            class_eval %[
+              def self.inherited klass
+                klass.const_set(:ID, #{id})
+                klass.const_set(:NAME, :#{name.to_s})
+                klass.parent.methods[#{id}] = klass
+                klass.parent.methods[klass::NAME] = klass
+              end
+            ]
+          end
+        end
+      end
+
+      def self.classes() @classes ||= {} end
+
+      def self.Class(id, name)
+        @_base_classes ||= {}
+        @_base_classes[id] ||= ::Class.new(Class) do
+          class_eval %[
+            def self.inherited klass
+              klass.const_set(:ID, #{id})
+              klass.const_set(:NAME, :#{name.to_s})
+              Protocol.classes[#{id}] = klass
+              Protocol.classes[klass::NAME] = klass
+            end
+          ]
+        end
+      end
+    end
+  end
+  
+  module Bunny
+    module Protocol
+      <%- s['classes'].each do |c| -%>
+      class <%= c['name'].capitalize.ljust(12) %> < Class( <%= c['id'].to_s.rjust(3) %>, :<%= c['name'].ljust(12) %> ); end
+      <%- end -%>
+
+      <%- s['classes'].each do |c| -%>
+      class <%= c['name'].capitalize %>
+        <%- c['properties'].each do |p| -%>
+        <%= p['type'].ljust(10) %> :<%= p['name'].tr('-','_') %>
+        <%- end if c['properties'] -%>
+
+        <%- c['methods'].each do |m| -%>
+        class <%= m['name'].capitalize.gsub(/-(.)/){ "#{$1.upcase}"}.ljust(12) %> < Method( <%= m['id'].to_s.rjust(3) %>, :<%= m['name'].tr('- ','_').ljust(14) %> ); end
+        <%- end -%>
+
+        <%- c['methods'].each do |m| -%>
+        class <%= m['name'].capitalize.gsub(/-(.)/){ "#{$1.upcase}"} %>
+          <%- m['arguments'].each do |a| -%>
+          <%- if a['domain'] -%>
+          <%= s['domains'].find{|k,v| k == a['domain']}.last.ljust(10) %> :<%= a['name'].tr('- ','_') %>
+          <%- else -%>
+          <%= a['type'].ljust(10) %> :<%= a['name'].tr('- ','_') %>
+          <%- end -%>
+          <%- end if m['arguments'] -%>
+        end
+
+        <%- end -%>
+      end
+
+      <%- end -%>
+    end
+  end
+].gsub!(/^  /,''), nil, '>-%').result(binding)

data/lib/bunny.rb

@@ -5,76 +5,34 @@ $:.unshift File.expand_path(File.dirname(__FILE__))
 	require file
 end
 
-# AMQP protocol and transport
-%w[spec protocol buffer frame].each do |file|
-	require 'engineroom/' + file
-end
+require 'bunny/client'
+require 'bunny/exchange'
+require 'bunny/queue'
 
-# Bunny API 
-%w[client exchange header queue].each do |file|
-	require 'bunny/' + file
-end
+require 'bunny/protocol/spec'
+require 'bunny/protocol/protocol'
 
-# Error and return message definitions
-require 'api_messages'
+require 'bunny/transport/buffer'
+require 'bunny/transport/frame'
 
-class Bunny
+module Bunny
+	
 	include Protocol
 	include Transport
-	include API
 
-	attr_reader :client
-
-	def initialize(opts = {})
-		@client = API::Client.new(opts)
-  end
-
-	def logging=(bool)
-		client.logging = bool
-	end
+	class ProtocolError < StandardError; end
+	class ServerDownError < StandardError; end
+	class BufferOverflowError < StandardError; end
+  class InvalidTypeError < StandardError; end
+	class ConnectionError < StandardError; end
+	class MessageError < StandardError; end
 	
-	def logging
-		client.logging
-	end
-
-	def start
-		client.start_session
-	end
-
-	def status
-		client.status
-	end
+	VERSION = '0.3.0'
 	
-	def exchange(name, opts = {})
-		client.exchanges[name] ||= API::Exchange.new(client, name, opts)
-	end
-  
-  def queue(name, opts = {})
-    client.queues[name] ||= API::Queue.new(client, name, opts)
-  end
-
-  def stop
-    client.close
-  end
-
-  def queues
-    client.queues ||= {}
-  end
+	# Returns the Bunny version number
 
-  def exchanges
-    client.exchanges ||= {}
-  end
-	
-	def host
-		client.host
-	end
-	
-	def vhost
-		client.vhost
-	end
-	
-	def port
-		client.port
+	def self.version
+		VERSION
 	end
-	
+
 end