rosetta_queue 0.4.0

data/spec/rosetta_queue/core_ext/string_spec.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe String do
+  describe "#camelize" do
+    it "should have code examples"
+  end
+
+  describe "#classify" do
+    it "should have code examples"
+  end
+
+  describe "#underscore" do
+    it "should have code examples"
+  end
+end

data/spec/rosetta_queue/destinations_spec.rb

@@ -0,0 +1,34 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module RosettaQueue
+
+  describe Destinations do
+
+    before(:each) do
+      Destinations.clear
+    end
+
+    after(:each) do
+      Destinations.clear
+    end
+
+    it "should map destination to hash" do
+
+      Destinations.define do |queue|
+        queue.map :test_queue, "/queue/test_queue"
+      end
+
+      Destinations.lookup(:test_queue).should == "/queue/test_queue"
+    end
+
+    it "#queue_names should return an array of the actuual queue names" do
+      Destinations.define do |queue|
+        queue.map :foo, "/queue/foo"
+        queue.map :bar, "/queue/bar"
+      end
+
+      Destinations.queue_names.should include("/queue/foo")
+      Destinations.queue_names.should include("/queue/bar")
+    end
+  end
+end

data/spec/rosetta_queue/exception_handler_spec.rb

@@ -0,0 +1,106 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module RosettaQueue
+
+  describe ExceptionHandler do
+
+    after(:each) do
+      ExceptionHandler.reset_handlers
+    end
+
+
+    describe "::handle" do
+      it "runs the given block returning the block's return value" do
+        ExceptionHandler::handle do
+          "foo"
+        end.should == "foo"
+      end
+
+      it "delegates raised exceptions to each related registered handler" do
+        # given
+        ExceptionHandler::register(:consuming, registered_handler = mock('exception handling'))
+        ExceptionHandler::register(:consuming, registered_handler2 = mock('exception handling'))
+        exception = StandardError.new
+        # expect
+        registered_handler.should_receive(:handle).with(exception, anything)
+        registered_handler2.should_receive(:handle).with(exception, anything)
+        # when
+        ExceptionHandler::handle(:consuming) do
+          raise exception
+        end
+      end
+
+      it "does not delegate raised exceptions to unrelated handlers" do
+        # given
+        ExceptionHandler::register(:consuming, consuming_handler = mock('consumner handling'))
+        ExceptionHandler::register(:publishing, publishing_handler = mock('publishing handling'))
+        exception = StandardError.new
+        # expect
+        consuming_handler.should_receive(:handle).with(exception, anything)
+        publishing_handler.should_not_receive(:handle)
+        # when
+        ExceptionHandler::handle(:consuming) do
+          raise exception
+        end
+      end
+
+      it "delegates all types of messaging exceptions to handlers registered under ':all'" do
+        # given
+        ExceptionHandler::register(:all, messaging_handler = mock('global message exception handling'))
+        exception = StandardError.new
+        # expect
+        messaging_handler.should_receive(:handle).with(exception, anything).twice
+        # when
+        ExceptionHandler::handle(:consuming) { raise exception }
+        ExceptionHandler::handle(:publishing) { raise exception }
+      end
+
+      it "passes any additional information (in form of a hash) to the registered handlers" do
+        # given
+        ExceptionHandler::register(:all, messaging_handler = mock('global message exception handling'))
+        info_hash = {:message => "this caused failure", :foo => "bar"}
+        # expect
+        messaging_handler.should_receive(:handle).with(anything, info_hash)
+        # when
+        ExceptionHandler::handle(:consuming, info_hash) { raise "FAIL" }
+      end
+
+      it "accepts a lambda for info and will pass it's evaluation along to the registered handlers" do
+        # given
+        ExceptionHandler::register(:all, messaging_handler = mock('global message exception handling'))
+        info_hash = {:message => "this caused failure", :foo => "bar"}
+        # expect
+        messaging_handler.should_receive(:handle).with(anything, info_hash)
+        # when
+        ExceptionHandler::handle(:consuming, lambda { info_hash }) { raise "FAIL" }
+
+      end
+
+
+      it "reraises the error when no handlers have been registed for the given action" do
+        ExceptionHandler::register(:consuming, consuming_handler = mock('consumner handling'))
+        running do
+          ExceptionHandler::handle(:publishing, {}) { raise "Foo" }
+        end.should raise_error(RuntimeError)
+      end
+
+
+    end
+
+    describe "::register" do
+      # see the examples for ::handle as well- since they are related.
+
+      it "takes an exception handling block in place of a class" do
+        # given
+        ExceptionHandler::register(:all) do |exception, info|
+          RosettaQueue.logger.error "whoops"
+        end
+        # expect
+        RosettaQueue.logger.should_receive(:error).with("whoops")
+        # when
+        ExceptionHandler::handle(:consuming) { raise "FAIL" }
+      end
+    end
+  end
+
+end

data/spec/rosetta_queue/filters_spec.rb

@@ -0,0 +1,57 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module RosettaQueue
+
+  describe Filters do
+
+    after(:each) do
+      Filters.reset
+    end
+
+    describe "#process_receiving" do
+      it "should process the passed in message with the defined receiving filter" do
+        Filters.define do |f|
+          f.receiving {|message| "Foo #{message}"}
+        end
+
+        Filters.process_receiving("Bar").should == "Foo Bar"
+      end
+
+      it "should return the same message when no filter is defined" do
+        Filters.process_receiving("Bar").should == "Bar"
+      end
+    end
+
+    ['sending', 'receiving'].each do |action|
+      describe "#safe_process_#{action}" do
+        it "returns the orginal message if an exception occurs while filtering" do
+          Filters.define do |f|
+            f.send(action) { |message| raise "foo" }
+          end
+
+          Filters.send("safe_process_#{action}", "Bar").should == "Bar"
+        end
+
+      end
+    end
+
+
+    describe "#process_sending" do
+      it "should process the passed in message with the defined sending filter" do
+        Filters.define do |f|
+          f.sending {|message| "Foo #{message}"}
+        end
+
+        Filters.process_sending("Bar").should == "Foo Bar"
+      end
+
+      it "should return the same message when no filter is defined" do
+        Filters.process_sending("Bar").should == "Bar"
+      end
+    end
+
+
+
+  end
+
+end

data/spec/rosetta_queue/message_handler_spec.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module RosettaQueue
+
+  class SimplerHandler
+    include MessageHandler
+    subscribes_to :test_queue
+    options :my => 'options'
+
+    def on_message(filtered_message)
+    end
+  end
+
+  describe MessageHandler do
+    before(:each) do
+      Filters.stub!(:safe_process_receiving => 'safely processed message')
+      @message_handler = SimplerHandler.new
+      Destinations.stub!(:lookup).and_return("/queue/test_queue")
+      ExceptionHandler.stub!(:handle).and_yield
+    end
+
+    describe "#handle_message" do
+      it "calls the ExceptionHandler for :publishing" do
+        ExceptionHandler.should_receive(:handle).with(:publishing, anything)
+        @message_handler.handle_message("foo")
+      end
+
+      it "filters the message" do
+        Filters.should_receive(:process_receiving).with("hello")
+        @message_handler.handle_message("hello")
+      end
+
+      it "provides additional message information to the ExceptionHandler" do
+        ExceptionHandler.should_receive(:handle).with do |_, hash_proc|
+          hash_proc.call.should == {
+          :message => "safely processed message",
+          :action => :consuming,
+          :destination => :test_queue,
+          :options => {:my => 'options'}}
+        end
+          @message_handler.handle_message("message")
+      end
+
+    end
+
+  end
+end

data/spec/rosetta_queue/producer_spec.rb

@@ -0,0 +1,77 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module RosettaQueue
+
+  class TestProducer < Producer
+
+    publishes_to :test_queue
+    options :persistent => false
+
+  end
+
+  describe Producer do
+
+    before(:each) do
+      @adapter = mock("adapter", :send_message => nil)
+      RosettaQueue::Adapter.stub!(:instance).and_return(@adapter)
+      @gateway  = TestProducer.new
+
+      Destinations.stub!(:lookup).and_return("/queue/test_queue")
+    end
+
+    it_should_behave_like "a messaging gateway object"
+    attr_reader :adapter, :gateway
+
+
+    describe "#publish" do
+
+      before(:each) do
+        @adapter = mock("adpater", :send_message => nil)
+        RosettaQueue::Adapter.stub!(:instance).and_return(@adapter)
+      end
+
+      it "should publish messages to queue with the options defined in the class" do
+        # TO DO: REFACTOR #publish METHOD SO THAT YOU PASS IN MESSAGE HANDLER AS WITH CONSUMER
+        pending
+        # expect
+        @adapter.should_receive(:send_message).with("/queue/test_queue", "Hello World!", {:persistent => false})
+        # when
+        @gateway.publish("Hello World!")
+      end
+
+    end
+
+    describe ".publish" do
+      it "should send the message to the adpater along with the options" do
+        # expect
+        @adapter.should_receive(:send_message).with("/queue/test_queue", "Hello World!", {:persistent => true})
+        # when
+        Producer.publish(:test_queue, "Hello World!", {:persistent => true})
+      end
+
+      it "delgates exception handling to the ExceptionHandler for :publishing" do
+        ExceptionHandler.should_receive(:handle).with(:publishing, anything)
+        Producer.publish(:test_queue, "Hello World!", {:persistent => true})
+      end
+
+      it "wraps the publishing in an ExceptionHandler::handler block" do
+        @adapter.should_not_receive(:send_message)
+        ExceptionHandler.stub!(:handle).and_return("I was wrapped")
+        Producer.publish(:test_queue, "m").should == "I was wrapped"
+      end
+
+      it "provides additional message information to the ExceptionHandler" do
+        ExceptionHandler.should_receive(:handle).with do |_, hash_proc|
+          hash_proc.call.should == {
+          :message => "message",
+          :action => :publishing,
+          :destination => :test_queue,
+          :options => {:persistent => true}}
+        end
+        Producer.publish(:test_queue, "message", {:persistent => true})
+      end
+
+    end
+
+  end
+end

data/spec/rosetta_queue/shared_messaging_behavior.rb

@@ -0,0 +1,21 @@
+module RosettaQueue
+
+  describe "a messaging gateway object", :shared => true do
+
+    it "#unsubscribe should be delegated to the adapter" do
+      pending
+      # expect
+      adapter.should_receive("unsubscribe")
+      # when
+      gateway.unsubscribe
+    end
+
+    it "#disconnect should be delegated to the adapter" do
+      # expect
+      adapter.should_receive("disconnect")
+      # when
+      gateway.disconnect
+    end
+
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--colour
+--loadby
+mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,47 @@
+ENV["MESSAGING_ENV"] = "test"
+
+require 'rubygems'
+require 'spec'
+require 'ruby-debug'
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'rosetta_queue'
+require 'rosetta_queue/adapters/null'
+require 'rosetta_queue/adapters/fake'
+require 'rosetta_queue/adapters/stomp'
+require 'rosetta_queue/adapters/amqp'
+require 'rosetta_queue/consumer_managers/base'
+require 'rosetta_queue/consumer_managers/evented'
+require 'rosetta_queue/consumer_managers/threaded'
+require 'rosetta_queue/spec_helpers'
+require 'rosetta_queue/consumer_managers/base'
+require 'rosetta_queue/consumer_managers/evented'
+require 'rosetta_queue/consumer_managers/threaded'
+require File.dirname(__FILE__) + '/rosetta_queue/shared_messaging_behavior.rb'
+
+class NullLogger
+  def info(*args);  end
+  def debug(*args); end
+  def fatal(*args); end
+  def error(*args); end
+  def warn(*args);  end
+end
+
+RosettaQueue.logger = NullLogger.new
+
+alias :running :lambda
+
+[:process, :receiving_with_handler, :receiving_once, :publishing, :disconnecting, :receiving_single_exchange, :receiving_exchange, :receiving].each do |action|
+  eval %Q{
+    def before_#{action}
+      yield
+      do_#{action}
+    end
+    alias during_#{action} before_#{action}
+    alias when_#{action} before_#{action}
+    def after_#{action}
+      do_#{action}
+      yield
+    end
+  }
+end

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification 
+name: rosetta_queue
+version: !ruby/object:Gem::Version 
+  version: 0.4.0
+platform: ruby
+authors: 
+- Ben Mabey
+- Chris Wyckoff
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-28 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: Messaging gateway API with adapters for many messaging systems available in Ruby. Messaging systems can be easily switched out with a small configuration change. Code for testing on the object and application level is also provided.
+email: cbwyckoff@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- MIT-LICENSE.txt
+- README.rdoc
+files: 
+- History.txt
+- MIT-LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- cucumber.yml
+- features/filtering.feature
+- features/messaging.feature
+- features/step_definitions/common_messaging_steps.rb
+- features/step_definitions/filtering_steps.rb
+- features/step_definitions/point_to_point_steps.rb
+- features/step_definitions/publish_subscribe_steps.rb
+- features/support/env.rb
+- features/support/sample_consumers.rb
+- lib/rosetta_queue.rb
+- lib/rosetta_queue/adapter.rb
+- lib/rosetta_queue/adapters/amqp.rb
+- lib/rosetta_queue/adapters/amqp_evented.rb
+- lib/rosetta_queue/adapters/amqp_synch.rb
+- lib/rosetta_queue/adapters/base.rb
+- lib/rosetta_queue/adapters/beanstalk.rb
+- lib/rosetta_queue/adapters/fake.rb
+- lib/rosetta_queue/adapters/null.rb
+- lib/rosetta_queue/adapters/stomp.rb
+- lib/rosetta_queue/base.rb
+- lib/rosetta_queue/consumer.rb
+- lib/rosetta_queue/consumer_managers/base.rb
+- lib/rosetta_queue/consumer_managers/evented.rb
+- lib/rosetta_queue/consumer_managers/threaded.rb
+- lib/rosetta_queue/core_ext/string.rb
+- lib/rosetta_queue/core_ext/time.rb
+- lib/rosetta_queue/destinations.rb
+- lib/rosetta_queue/exception_handler.rb
+- lib/rosetta_queue/exceptions.rb
+- lib/rosetta_queue/filters.rb
+- lib/rosetta_queue/logger.rb
+- lib/rosetta_queue/message_handler.rb
+- lib/rosetta_queue/producer.rb
+- lib/rosetta_queue/spec_helpers.rb
+- lib/rosetta_queue/spec_helpers/hash.rb
+- lib/rosetta_queue/spec_helpers/helpers.rb
+- lib/rosetta_queue/spec_helpers/publishing_matchers.rb
+- spec/rosetta_queue/adapter_spec.rb
+- spec/rosetta_queue/adapters/amqp_synchronous_spec.rb
+- spec/rosetta_queue/adapters/beanstalk_spec.rb
+- spec/rosetta_queue/adapters/fake_spec.rb
+- spec/rosetta_queue/adapters/null_spec.rb
+- spec/rosetta_queue/adapters/shared_adapter_behavior.rb
+- spec/rosetta_queue/adapters/shared_fanout_behavior.rb
+- spec/rosetta_queue/adapters/stomp_spec.rb
+- spec/rosetta_queue/consumer_managers/evented_spec.rb
+- spec/rosetta_queue/consumer_managers/shared_manager_behavior.rb
+- spec/rosetta_queue/consumer_managers/threaded_spec.rb
+- spec/rosetta_queue/consumer_spec.rb
+- spec/rosetta_queue/core_ext/string_spec.rb
+- spec/rosetta_queue/destinations_spec.rb
+- spec/rosetta_queue/exception_handler_spec.rb
+- spec/rosetta_queue/filters_spec.rb
+- spec/rosetta_queue/message_handler_spec.rb
+- spec/rosetta_queue/producer_spec.rb
+- spec/rosetta_queue/shared_messaging_behavior.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/cwyckoff/rosetta_queue
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rosetta-queue
+rubygems_version: 1.3.3
+signing_key: 
+specification_version: 3
+summary: Messaging gateway API with adapters for many messaging systems available in Ruby.
+test_files: 
+- spec/rosetta_queue/adapter_spec.rb
+- spec/rosetta_queue/adapters/amqp_synchronous_spec.rb
+- spec/rosetta_queue/adapters/beanstalk_spec.rb
+- spec/rosetta_queue/adapters/fake_spec.rb
+- spec/rosetta_queue/adapters/null_spec.rb
+- spec/rosetta_queue/adapters/shared_adapter_behavior.rb
+- spec/rosetta_queue/adapters/shared_fanout_behavior.rb
+- spec/rosetta_queue/adapters/stomp_spec.rb
+- spec/rosetta_queue/consumer_managers/evented_spec.rb
+- spec/rosetta_queue/consumer_managers/shared_manager_behavior.rb
+- spec/rosetta_queue/consumer_managers/threaded_spec.rb
+- spec/rosetta_queue/consumer_spec.rb
+- spec/rosetta_queue/core_ext/string_spec.rb
+- spec/rosetta_queue/destinations_spec.rb
+- spec/rosetta_queue/exception_handler_spec.rb
+- spec/rosetta_queue/filters_spec.rb
+- spec/rosetta_queue/message_handler_spec.rb
+- spec/rosetta_queue/producer_spec.rb
+- spec/rosetta_queue/shared_messaging_behavior.rb
+- spec/spec_helper.rb
+- examples/sample_amqp_consumer.rb
+- examples/sample_amqp_fanout_consumer.rb
+- examples/sample_amqp_fanout_producer.rb
+- examples/sample_amqp_producer.rb