stomper 0.3.0

data/spec/transaction_spec.rb

@@ -0,0 +1,139 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
+
+module Stomper
+  describe Transaction do
+    before(:each) do
+      @mock_client = mock("client")
+    end
+
+    describe "initialization with blocks" do
+      before(:each) do
+        @mock_client.should_receive(:begin).once.with(an_instance_of(String)).and_return(nil)
+        @mock_client.should_receive(:send).once.with("/queue/test/1","a message", an_instance_of(Hash)).and_return(nil)
+        @mock_client.should_receive(:commit).once.with(an_instance_of(String)).and_return(nil)
+      end
+
+
+      it "should provide a DSL when a block with no arguments is given" do
+        lambda do
+          Transaction.new(@mock_client) do
+            send("/queue/test/1", "a message")
+          end
+        end.should_not raise_error
+      end
+
+      it "should yield itself when a block with arguments is given" do
+        lambda do
+          Transaction.new(@mock_client) do |t|
+            t.send("/queue/test/1", "a message")
+          end
+        end.should_not raise_error
+      end
+    end
+
+    describe "explicitly named" do
+      before(:each) do
+        @transaction_name = "tx-test"
+        @mock_client.should_receive(:begin).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_receive(:send).once.with("/queue/test/1","test message", hash_including("transaction" => @transaction_name)).and_return(nil)
+        @mock_client.should_receive(:commit).once.with(@transaction_name).and_return(nil)
+      end
+
+      it "should use the given transaction ID as the transaction header in stomp messages" do
+        Transaction.new(@mock_client, @transaction_name) do |t|
+          t.send("/queue/test/1", "test message")
+        end
+      end
+    end
+
+    describe "aborting failed transactions" do
+      before(:each) do
+        @transaction_name = "tx-test-2"
+        @mock_client.should_receive(:begin).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_receive(:send).once.with("/queue/test/1","test message", hash_including("transaction" => @transaction_name)).and_return(nil)
+      end
+
+      it "should abort when an exception is raised" do
+        @mock_client.should_receive(:abort).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_not_receive(:commit)
+        lambda do
+          Transaction.new(@mock_client, @transaction_name) do |t|
+            t.send("/queue/test/1", "test message")
+            raise "Never to be completed!"
+          end
+        end.should raise_error(TransactionAborted)
+      end
+
+      it "should abort and raise an error when explicitly aborted" do
+        @mock_client.should_receive(:abort).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_not_receive(:commit)
+        lambda do
+          Transaction.new(@mock_client, @transaction_name) do |t|
+            t.send("/queue/test/1", "test message")
+            t.abort
+            # This should never be reached.
+            t.commit
+          end
+        end.should raise_error(TransactionAborted)
+      end
+
+      it "should not raise an exception when explicitly aborted after a commit" do
+        @mock_client.should_not_receive(:abort)
+        @mock_client.should_receive(:commit).once.with(@transaction_name).and_return(nil)
+        lambda do
+          Transaction.new(@mock_client, @transaction_name) do |t|
+            t.send("/queue/test/1", "test message")
+            t.commit
+            t.abort
+          end
+        end.should_not raise_error(TransactionAborted)
+      end
+    end
+
+    describe "nested transactions" do
+      before(:each) do
+        @transaction_name = "tx-test-3"
+        @inner_transaction_name = "#{@transaction_name}-inner"
+        @inner_inner_transaction_name = "#{@transaction_name}-inner-inner"
+        @mock_client.should_receive(:begin).with(@transaction_name).once.and_return(nil)
+        @mock_client.should_receive(:begin).with(@inner_transaction_name).once.and_return(nil)
+        @mock_client.should_receive(:send).with("/queue/test/1","test message", hash_including("transaction" => @transaction_name)).once.and_return(nil)
+        @mock_client.should_receive(:send).with("/queue/test/2","inner message", hash_including("transaction" => @inner_transaction_name)).once.and_return(nil)
+      end
+      it "no transaction should succeed when an inner one fails" do
+        @mock_client.should_receive(:abort).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_receive(:abort).once.with(@inner_transaction_name).and_return(nil)
+        @mock_client.should_not_receive(:commit)
+        lambda do
+          Transaction.new(@mock_client, @transaction_name) do |t|
+            t.send("/queue/test/1", "test message")
+            t.transaction(@inner_transaction_name) do |nt|
+              nt.send("/queue/test/2", "inner message")
+              raise "failure"
+            end
+          end
+        end.should raise_error(TransactionAborted)
+      end
+      it "no transaction should succeed when an inner one is explicitly aborted" do
+        @mock_client.should_receive(:begin).with(@inner_inner_transaction_name).once.and_return(nil)
+        @mock_client.should_receive(:send).with("/queue/test/3","inner-inner message", hash_including("transaction" => @inner_inner_transaction_name)).once.and_return(nil)
+        @mock_client.should_receive(:abort).once.with(@transaction_name).and_return(nil)
+        @mock_client.should_receive(:abort).once.with(@inner_transaction_name).and_return(nil)
+        @mock_client.should_receive(:abort).once.with(@inner_inner_transaction_name).and_return(nil)
+        @mock_client.should_not_receive(:commit)
+        lambda do
+          Transaction.new(@mock_client, @transaction_name) do |t|
+            t.send("/queue/test/1", "test message")
+            t.transaction(@inner_transaction_name) do |nt|
+              nt.send("/queue/test/2", "inner message")
+              nt.transaction(@inner_inner_transaction_name) do |nnt|
+                nnt.send("/queue/test/3", "inner-inner message")
+                nnt.abort
+              end
+            end
+          end
+        end.should raise_error(TransactionAborted)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification 
+name: stomper
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
+platform: ruby
+authors: 
+- Ian D. Eccles
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-04 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Ruby client for the stomp messaging protocol derived from the original stomp gem
+email: 
+- ian.eccles@gmali.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- CHANGELOG
+- LICENSE
+- AUTHORS
+files: 
+- lib/stomper/subscription.rb
+- lib/stomper/frames.rb
+- lib/stomper/transaction.rb
+- lib/stomper/subscriptions.rb
+- lib/stomper/frames/send.rb
+- lib/stomper/frames/receipt.rb
+- lib/stomper/frames/ack.rb
+- lib/stomper/frames/client_frame.rb
+- lib/stomper/frames/disconnect.rb
+- lib/stomper/frames/message.rb
+- lib/stomper/frames/error.rb
+- lib/stomper/frames/connected.rb
+- lib/stomper/frames/server_frame.rb
+- lib/stomper/frames/begin.rb
+- lib/stomper/frames/unsubscribe.rb
+- lib/stomper/frames/connect.rb
+- lib/stomper/frames/headers.rb
+- lib/stomper/frames/abort.rb
+- lib/stomper/frames/commit.rb
+- lib/stomper/frames/subscribe.rb
+- lib/stomper/client.rb
+- lib/stomper/connection.rb
+- lib/stomper.rb
+- spec/subscriptions_spec.rb
+- spec/spec_helper.rb
+- spec/shared_connection_examples.rb
+- spec/spec.opts
+- spec/frames/server_frame_spec.rb
+- spec/frames/client_frame_spec.rb
+- spec/frames/headers_spec.rb
+- spec/connection_spec.rb
+- spec/subscription_spec.rb
+- spec/client_spec.rb
+- spec/transaction_spec.rb
+- README.rdoc
+- CHANGELOG
+- LICENSE
+- AUTHORS
+has_rdoc: true
+homepage: http://github.com/iande/stomper
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --quiet
+- --title
+- stomper documentation
+- --opname
+- index.html
+- --line-numbers
+- --main
+- README.rdoc
+- --inline-source
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Ruby client for the stomp messaging protocol derived from the original stomp gem
+test_files: 
+- spec/subscriptions_spec.rb
+- spec/spec_helper.rb
+- spec/shared_connection_examples.rb
+- spec/spec.opts
+- spec/frames/server_frame_spec.rb
+- spec/frames/client_frame_spec.rb
+- spec/frames/headers_spec.rb
+- spec/connection_spec.rb
+- spec/subscription_spec.rb
+- spec/client_spec.rb
+- spec/transaction_spec.rb