amqp-spec 0.0.4

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/HISTORY

@@ -0,0 +1,19 @@
+== 0.0.0 / 2010-10-13
+
+* Birthday!
+
+== 0.0.1 / 2010-10-13
+
+* Initial code import from EM-Spec and AMQPHelper
+
+== 0.0.2 / 2010-10-13
+
+* Minimal functionality implemented
+
+== 0.0.3 / 2010-10-13
+
+* Bunch of non-working specs added
+
+== 0.0.4 / 2010-10-14
+
+* Problems with default_options resolved

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Arvicco
+
+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.rdoc

@@ -0,0 +1,169 @@
+= amqp-spec
+by: Arvicco
+url: http://github.com/arvicco/amqp-spec
+
+== Summary
+
+Simple API for testing asynchronous EventMachine/AMQP code.
+
+== Description
+
+EventMachine-based code, including synchronous {AMQP library}[http://github.com/tmm1/amqp] is
+notoriously difficult to test. To the point that many people recommend using either
+Mocks[http://github.com/danielsdeleo/moqueue] or {synchronous libraries}[http://github.com/celldee/bunny]
+instead of EM-based libraries in unit tests. This is not always an option, however - sometimes your code
+is supposed to run inside event loop, and you want to test a real thing, not mocks.
+
+EM-Spec[http://github.com/tmm1/em-spec] gem made it easier to write evented specs, but it has several drawbacks.
+First, it is not easy to manage both EM.run and AMQP.start loops at the same time. Second, AMQP is not
+properly stopped and deactivated upon exceptions and timeouts, resulting in AMQP library state leak
+between examples and multiple mystereous failures.
+
+AMQP-Spec is built upon EM-Spec code but makes it easier to test AMQP event loops specifically. API is
+very similar to EM-Spec, only a bit extended. The final goal is to make writing AMQP specs reasonably
+pleasant experience and dispel the notion that evented AMQP-based libs are impossible to unit-test.
+
+Mind you, you still have to properly manage your AMQP broker in order to prevent broker state from leaking
+between examples. You can try to combine AMQP-Spec and Moqueue[http://github.com/danielsdeleo/moqueue]
+if you want to abstract away actual broker interactions, but still specify some event-based expectations.
+
+==Rspec
+There are several ways to use amqp-spec. To use it as a helper, include AMQP::SpecHelper in your describe block.
+You then use either 'amqp' or 'em' methods to wrap your evented test code. Inside the amqp/em block, you must call
+#done after your expectations. Everything works normally otherwise. You can use default_timeout and default_options
+macros to avoid manually setting AMQP options in each example. However, if you DO manually set options inside
+the example, they override the defaults. Only one set of default options and default timeout is used across groups,
+it is not possible to have separate defaults for separate groups.
+
+  require "amqp-spec/rspec"
+  describe AMQP do
+    include AMQP::SpecHelper
+  
+    before(:each) do
+      puts EM.reactor_running?
+    end
+
+    it "works normally when not using #amqp or #em" do
+      1.should == 1
+    end
+  
+    it "makes testing evented code easy with #em" do
+      em do
+        start = Time.now
+
+        EM.add_timer(0.5){
+          (Time.now-start).should be_close( 0.5, 0.1 )
+          done
+        }
+      end
+    end
+
+    it "runs AMQP.start loop with options given to #amqp" do
+      amqp(:host => 'my.amqp.broker.org', :port => '21118')do
+        AMQP.conn.should be_connected
+        done
+      end
+    end
+
+    it "optionally raises timeout exception if your loop hangs for some reason" do
+      proc {
+        amqp(:spec_timeout => 3){}
+      }.should raise_error SpecTimeoutExceededError
+    end
+
+    default_timeout 1 # Can be used to set default :spec_timeout for all your amqp-based specs
+  end
+
+Another option is to include AMQP::Spec in your describe block. This will patch Rspec so that all of your
+examples run inside an amqp block automatically. A word of caution about before{} and after{} hooks in your example
+groups including AMQP::Spec. Each of these hooks will run in its separate EM loop that you'll need to shut down
+either manually (done) or via default_timeout. Essentially, this means that any EM-related state that you'd like
+to setup/teardown using these hooks will be lost as each example will run in a separate thread. In order to
+run setup/teardown hooks inside the EM loop, you'll need to use before_amqp{} and after_amqp{} hooks that run
+inside the EM loop but before/after AMQP loop (these hooks are currently not implemented)
+
+  require "amqp-spec/rspec"
+  describe AMQP do
+    include AMQP::Spec
+
+    before(:each) do
+      puts EM.reactor_running?
+      done
+    end
+
+    default_options :host => 'my.amqp.broker.org', :port => '21118'
+    # Can be used to set default options for all your (implied) amqp{} event loops
+
+    it "requires a call to #done in every example" do
+      1.should == 1
+      done
+    end
+    
+    it "runs test code in an amqp block automatically" do
+      start = Time.now
+
+      EM.add_timer(0.5){
+        (Time.now-start).should be_close( 0.5, 0.1 )
+        done
+      }
+    end
+
+    it "runs AMQP.start loop with default_options" do
+      AMQP.conn.should be_connected
+      done
+    end
+
+    it "raises timeout exception ONLY if default_timeout was set" do
+      proc{}.should raise_error SpecTimeoutExceededError
+    end
+  end
+
+Finally, you can include AMQP::EMSpec in your describe block. This will run all the group examples
+inside em block instead of amqp. before{} and after{} hooks should be finished with 'done', same as
+when including AMQP::Spec, and same caution about using them applies.
+
+  require "amqp-spec/rspec"
+  describe AMQP do
+    include AMQP::EMSpec
+
+    it "requires a call to #done in every example" do
+      1.should == 1
+      done
+    end
+
+    it "runs test code in an amqp block automatically" do
+      start = Time.now
+
+      EM.add_timer(0.5){
+        (Time.now-start).should be_close( 0.5, 0.1 )
+        done
+      }
+    end
+
+    default_timeout 1
+    # Default spec timeouts can be used same as with AMQP::Spec, default_options (if defined) are not used
+  end
+
+
+==Bacon
+
+...
+
+==Test::Unit
+
+...
+
+==Limitations
+
+AMQP-Spec can be currently used with rspec only. I suppose, there is nothing special in extending EM-Spec's
+test unit and bacon support, I just do not have experience dealing with these platforms. Another limitation,
+it uses native Fibers and therefore not compatible with Ruby 1.8. Again, it seems possible to rewrite it in
+1.8-compatible style, with string evals and Fiber backport, but I'd rather leave this work to someone else.
+
+Any help improving this library is greatly appreciated...
+
+== LICENSE:
+Copyright (c) 2010 Arvicco.
+Original EM-Spec code copyright (c) 2008 Aman Gupta (tmm1)
+
+See LICENSE for details.

data/Rakefile

@@ -0,0 +1,24 @@
+require 'pathname'
+NAME = 'amqp-spec'
+BASE_PATH = Pathname.new(__FILE__).dirname
+LIB_PATH =  BASE_PATH + 'lib'
+PKG_PATH =  BASE_PATH + 'pkg'
+DOC_PATH =  BASE_PATH + 'rdoc'
+
+$LOAD_PATH.unshift LIB_PATH.to_s
+require 'version'
+
+CLASS_NAME = AMQP::Spec
+VERSION = CLASS_NAME::VERSION
+
+begin
+  require 'rake'
+rescue LoadError
+  require 'rubygems'
+  gem 'rake', '~> 0.8.3.1'
+  require 'rake'
+end
+
+# Load rakefile tasks
+Dir['tasks/*.rake'].sort.each { |file| load file }
+

data/VERSION

@@ -0,0 +1 @@
+0.0.4

data/lib/amqp-spec.rb

@@ -0,0 +1,27 @@
+require 'version'
+
+module AMQP
+  module Spec
+
+#  require "bundler"
+#  Bundler.setup
+
+    # Requires ruby source file(s). Accepts either single filename/glob or Array of filenames/globs.
+    # Accepts following options:
+    # :*file*:: Lib(s) required relative to this file - defaults to __FILE__
+    # :*dir*:: Required lib(s) located under this dir name - defaults to gem name
+    #
+    def self.require_libs(libs, opts={})
+      file = Pathname.new(opts[:file] || __FILE__)
+      [libs].flatten.each do |lib|
+        name = file.dirname + (opts[:dir] || file.basename('.*')) + lib.gsub(/(?<!.rb)$/, '.rb')
+        Pathname.glob(name.to_s).sort.each { |rb| require rb }
+      end
+    end
+  end
+end
+
+# Require all ruby source files located under directory lib/amqp-spec
+# If you need files in specific order, you should specify it here before the glob
+AMQP::Spec.require_libs %W[**/*]
+

data/lib/amqp-spec/rspec.rb

@@ -0,0 +1,195 @@
+require 'mq'
+require 'fiber' unless Fiber.respond_to?(:current)
+
+# You can include one of the following modules into your example groups:
+# AMQP::SpecHelper
+# AMQP::Spec
+#
+# AMQP::SpecHelper module defines 'ampq' method that can be safely used inside your specs(examples)
+# to test expectations inside running AMQP.start loop. Each loop is running in a separate Fiber,
+# and you can control for timeouts using either :spec_timeout option given to amqp method,
+# or setting default timeout with class method default_timeout(timeout).
+#
+# If you include AMQP::Spec module into your example group, each example of this group will run
+# inside AMQP.start loop without the need to explicitly call 'amqp'. In order to provide options
+# to AMQP loop, default_options class method is defined. Remember, when using AMQP::Specs, you
+# will have a single set of AMQP.start options for all your examples.
+#
+# In order to stop AMQP loop, you should call 'done' AFTER you are sure that your example is finished.
+# For example, if you are using subscribe block that tests expectations on messages, 'done' should be
+# probably called at the end of this block.
+#
+# TODO: Define 'async' method wrapping async requests and returning results... 'async_loop' too for subscribe?
+# TODO: 'evented_before', 'evented_after' that will be run inside EM before the example
+module AMQP
+  module SpecHelper
+
+    SpecTimeoutExceededError = Class.new(RuntimeError)
+
+    def self.included(example_group)
+      ::Spec::Example::ExampleGroup.instance_exec do
+        unless defined? default_spec_timeout
+
+          @@_em_default_options = {}
+          @@_em_default_timeout = nil
+
+          def self.default_spec_timeout(spec_timeout=nil)
+            if spec_timeout
+              @@_em_default_timeout = spec_timeout
+            else
+              @@_em_default_timeout
+            end
+          end
+          alias default_timeout default_spec_timeout
+
+          def self.default_options(opts=nil)
+            if opts
+              @@_em_default_options = opts
+            else
+              @@_em_default_options
+            end
+          end
+        end
+      end
+    end
+
+    # Yields to given block inside EM.run and AMQP.start loops. This method takes any option that is
+    # also accepted by EventMachine::connect. Also, options for AMQP.start include:
+    # * :user => String (default ‘guest’) - The username as defined by the AMQP server.
+    # * :pass => String (default ‘guest’) - The password for the associated :user as defined by the AMQP server.
+    # * :vhost => String (default ’/’)    - The virtual host as defined by the AMQP server.
+    # * :timeout => Numeric (default nil) - *Connection* timeout, measured in seconds.
+    # * :logging => true | false (default false) - Toggle the extremely verbose AMQP logging.
+    #
+    # In addition to EM and AMQP options, :spec_timeout option (in seconds) is used to force spec to timeout
+    # if something goes wrong and EM/AMQP loop hangs for some reason. SpecTimeoutExceededError is raised.
+
+    def amqp opts={}, &block
+      opts = @@_em_default_options.merge opts
+      EM.run do
+#        begin ?
+        @_em_spec_with_amqp = true
+        @_em_spec_exception = nil
+        spec_timeout = opts.delete(:spec_timeout) || @@_em_default_timeout
+        timeout(spec_timeout) if spec_timeout
+        @_em_spec_fiber = Fiber.new do
+          begin
+            amqp_start opts, &block
+          rescue Exception => @_em_spec_exception
+            p @_em_spec_exception
+            done
+          end
+          Fiber.yield
+        end
+
+        @_em_spec_fiber.resume
+#        raise @_em_spec_exception if @_em_spec_exception
+      end
+    end
+
+    # Yields to block inside EM loop, :spec_timeout option (in seconds) is used to force spec to timeout
+    # if something goes wrong and EM/AMQP loop hangs for some reason. SpecTimeoutExceededError is raised.
+    # TODO: accept :spec_timeout =>1 as a Hash for compatibility with amqp interface
+    def em(spec_timeout = @@_em_default_timeout, &block)
+      EM.run do
+        @_em_spec_with_amqp = false
+        @_em_spec_exception = nil
+        timeout(spec_timeout) if spec_timeout
+        @_em_spec_fiber = Fiber.new do
+          begin
+            block.call
+          rescue Exception => @_em_spec_exception
+            done
+          end
+          Fiber.yield
+        end
+
+        @_em_spec_fiber.resume
+      end
+    end
+
+    # Sets timeout for current spec
+    def timeout(spec_timeout)
+      EM.cancel_timer(@_em_timer) if @_em_timer
+      @_em_timer = EM.add_timer(spec_timeout) do
+        @_em_spec_exception = SpecTimeoutExceededError.new
+        done
+      end
+    end
+
+    # Stops AMQP and EM event loop
+    def done
+      EM.next_tick do
+        if @_em_spec_with_amqp
+          amqp_stop(@_em_spec_exception) do
+            finish_em_spec_fiber
+          end
+        else
+          finish_em_spec_fiber
+          raise @_em_spec_exception if @_em_spec_exception
+        end
+      end
+    end
+
+    private
+
+    def finish_em_spec_fiber
+      EM.stop_event_loop if EM.reactor_running?
+#      p Thread.current, Thread.current[:mq], __LINE__
+      @_em_spec_fiber.resume if @_em_spec_fiber.alive?
+    end
+
+    # Private method that initializes AMQP client/connection without starting another EM loop
+    def amqp_start opts={}, &block
+      AMQP.instance_exec do
+#  p Thread.current, Thread.current[:mq]
+        puts "!!!!!!!!! Existing connection: #{@conn}" if @conn
+        @conn = connect opts
+#       @conn ||= connect opts
+        @conn.callback(&block) if block
+      end
+    end
+
+    # Private method that closes AMQP connection and raises optional
+    # exception AFTER the AMQP connection is 100% closed
+    def amqp_stop exception
+      if AMQP.conn and not AMQP.closing
+        AMQP.instance_exec do #(@_em_spec_exception) do |exception|
+          @closing = true
+          @conn.close {
+            yield if block_given?
+            @conn = nil
+            @closing = false
+            raise exception if exception
+          }
+        end
+      end
+    end
+  end
+
+  module Spec
+    def self.included(cls)
+      cls.send(:include, SpecHelper)
+    end
+
+    def instance_eval(&block)
+      amqp do
+        super(&block)
+      end
+    end
+  end
+
+  module EMSpec
+    def self.included(cls)
+      cls.send(:include, SpecHelper)
+    end
+
+    def instance_eval(&block)
+      em do
+        super(&block)
+      end
+    end
+  end
+end
+
+

data/lib/version.rb

@@ -0,0 +1,10 @@
+require 'pathname'
+
+module AMQP
+  module Spec
+
+    VERSION_FILE = Pathname.new(__FILE__).dirname + '../VERSION' # :nodoc:
+    VERSION = VERSION_FILE.exist? ? VERSION_FILE.read.strip : nil
+
+  end
+end

data/spec/amqp.yml

@@ -0,0 +1,28 @@
+# AMQP client configuration file
+
+# These values will be used to configure the ampq gem, any values
+# omitted will let the gem use it's own defaults.
+
+# The configuration specifies the following keys:
+# * user - Username for the broker
+# * pass - Password for the broker
+# * host     - Hostname where the broker is running
+# * vhost    - Vhost to connect to
+# * port     - Port where the broker is running
+# * ssl      - Use ssl or not
+# * timeout  - Timeout
+
+defaults: &defaults
+  user: guest
+  pass: guest
+  host: 10.211.55.2
+  vhost: /
+
+development:
+  <<: *defaults
+
+test:
+  <<: *defaults
+
+production:
+  <<: *defaults

data/spec/failing_rspec_spec.rb

@@ -0,0 +1,62 @@
+require_relative 'spec_helper.rb'
+
+context 'Following examples should all be failing:' do
+  describe EventMachine, " when running failing examples" do
+    include AMQP::EMSpec
+
+    it "should not bubble failures beyond rspec" do
+      EM.add_timer(0.1) do
+        :should_not_bubble.should == :failures
+        done
+      end
+    end
+
+    it "should not block on failure" do
+      1.should == 2
+    end
+  end
+
+  describe EventMachine, " when testing with AMQP::EMSpec with a maximum execution time per test" do
+
+    include AMQP::EMSpec
+    it 'should timeout before reaching done' do
+      EM.add_timer(2) {
+        done
+      }
+    end
+
+    it 'should timeout before reaching done' do
+      timeout(0.3)
+      EM.add_timer(0.6) {
+        done
+      }
+    end
+  end
+
+  describe AMQP, " when testing with AMQP::Spec with a maximum execution time per test" do
+
+    include AMQP::Spec
+
+    default_timeout 1
+
+    it 'should timeout before reaching done' do
+      EM.add_timer(2) {
+        done
+      }
+    end
+
+    it 'should timeout before reaching done' do
+      timeout(0.2)
+      EM.add_timer(0.5) {
+        done
+      }
+    end
+
+    it 'should fail due to timeout, not hang up' do
+      timeout(0.2)
+    end
+
+    it 'should fail due to default timeout, not hang up' do
+    end
+  end
+end

data/spec/rspec_amqp_spec.rb

@@ -0,0 +1,273 @@
+require_relative 'spec_helper.rb'
+
+describe 'Rspec' do
+  it 'should work as normal without AMQP-Spec' do
+    1.should == 1
+  end
+end
+
+context 'Evented AMQP specs' do
+  describe AMQP, " when testing with AMQP::SpecHelper" do
+    include AMQP::SpecHelper
+    after(:each) do
+      EM.reactor_running?.should == false
+      AMQP.conn.should be_nil
+    end
+
+    default_options AMQP_OPTS if defined? AMQP_OPTS
+    default_timeout 1 # Can be used to set default :spec_timeout for all your amqp-based specs
+
+    p default_timeout, default_options
+
+    it "should not require a call to done when #em/#amqp is not used" do
+      1.should == 1
+    end
+
+    it "should properly work" do
+      amqp do
+        done
+      end
+    end
+
+    it "should have timers" do
+      amqp do
+        start = Time.now
+
+        EM.add_timer(0.5) {
+          (Time.now-start).should be_close(0.5, 0.1)
+          done
+        }
+      end
+    end
+
+    it "should run AMQP.start loop with options given to #amqp" do
+      amqp(:vhost => '/', :user => 'guest') do
+        AMQP.conn.should be_connected
+        done
+      end
+    end
+
+    it "should properly close AMQP connection if block completes normally" do
+      amqp do
+        AMQP.conn.should be_connected
+        done
+      end
+      AMQP.conn.should be_nil
+    end
+
+    it 'should have deferrables' do
+      amqp do
+        defr = EM::DefaultDeferrable.new
+        defr.timeout(0.5)
+        defr.errback {
+          done
+        }
+      end
+    end
+
+    context 'on exceptions/failures' do
+#      default_timeout 1 # Can be used to set default :spec_timeout for all your amqp-based specs
+
+
+    end
+  end
+
+  describe AMQP, " when testing with AMQP::Spec" do
+    include AMQP::Spec
+    after(:each) do
+      EM.reactor_running?.should == true
+      done
+    end
+
+    it 'should work' do
+      done
+    end
+
+    it 'should have timers' do
+      start = Time.now
+
+      EM.add_timer(0.5) {
+        (Time.now-start).should be_close(0.5, 0.1)
+        done
+      }
+    end
+
+    it 'should have periodic timers' do
+      num = 0
+      start = Time.now
+
+      timer = EM.add_periodic_timer(0.25) {
+        if (num += 1) == 2
+          (Time.now-start).should be_close(0.5, 0.1)
+          EM.cancel_timer timer
+          done
+        end
+      }
+    end
+
+    it 'should have deferrables' do
+      defr = EM::DefaultDeferrable.new
+      defr.timeout(0.5)
+      defr.errback {
+        done
+      }
+    end
+  end
+
+  shared_examples_for 'timeout examples' do
+    include AMQP::SpecHelper
+    before(:each) { @start = Time.now }
+
+    it 'should timeout before reaching done because of default spec timeout' do
+      proc {
+        amqp do
+          EM.add_timer(2) { done }
+        end
+      }.should raise_error SpecTimeoutExceededError
+      (Time.now-@start).should be_close(1.0, 0.1)
+    end
+
+    it 'should timeout before reaching done because of explicit in-loop timeout' do
+      proc {
+        amqp do
+          timeout(0.2)
+          EM.add_timer(0.5) { done }
+        end
+      }.should raise_error SpecTimeoutExceededError
+      (Time.now-@start).should be_close(0.2, 0.1)
+    end
+
+    specify "spec timeout given in amqp options has higher priority than default" do
+      proc {
+        amqp(:spec_timeout => 0.2) {}
+      }.should raise_error SpecTimeoutExceededError
+      (Time.now-@start).should be_close(0.2, 0.1)
+    end
+
+    specify "but timeout call inside amqp loop has even higher priority" do
+      proc {
+        amqp(:spec_timeout => 0.5) { timeout(0.2) }
+      }.should raise_error SpecTimeoutExceededError
+      (Time.now-@start).should be_close(0.2, 0.1)
+    end
+
+    specify "AMQP connection should not leak between examples" do
+      AMQP.conn.should be_nil
+    end
+  end
+
+  describe AMQP, " when testing with AMQP::SpecHelper with spec timeouts" do
+    it_should_behave_like 'timeout examples'
+
+    context 'inside embedded context / example group' do
+      it_should_behave_like 'timeout examples'
+#      it "should properly timeout " do
+#        amqp do
+#          timeout(0.2)
+#        end
+#      end
+#      it "should properly timeout inside embedded context/describe blocks" do
+#        amqp do
+#        end
+#      end
+    end
+  end
+
+# PROBLEMATIC !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+  describe AMQP, " when testing with AMQP::SpecHelper with spec timeouts" do
+    include AMQP::SpecHelper
+
+    it "should fail to provide context to next spec" do
+      begin
+        amqp do
+          :this.should == :fail
+        end
+      rescue => e
+        p e
+      end
+    end
+
+    it "should properly close AMQP connection after Rspec failures" do
+      AMQP.conn.should == nil
+    end
+  end
+
+#  describe MQ, " when MQ.queue or MQ.fanout etc is trying to access Thread-local mq across examples" do
+#    include AMQP::SpecHelper
+#
+#    default_timeout 1
+#
+#    it 'sends data to queue' do
+#      amqp do
+#        q = MQ.new.queue("test_sink")
+#        q.subscribe do |hdr, data|
+#          p hdr, data
+#          EM.next_tick {
+#            q.unsubscribe; q.delete
+#            AMQP.stop { EM.stop_event_loop }
+#          }
+#        end
+#        EM.add_timer(0.2) do
+#          p Thread.current, Thread.current[:mq]
+#          MQ.queue('test_sink').publish 'data' # MQ.new. !!!!!!!!!!!
+#        end
+#      end
+#    end
+#
+#    it 'sends data to queue' do
+#      amqp do
+#        q = MQ.new.queue("test_sink")
+#        q.subscribe do |hdr, data|
+#          p hdr, data
+#          EM.next_tick {
+#            q.unsubscribe; q.delete
+#            AMQP.stop { EM.stop_event_loop }
+#          }
+#        end
+#        EM.add_timer(0.2) do
+#          p Thread.current, Thread.current[:mq]
+#          MQ.queue('test_sink').publish 'data' # MQ.new. !!!!!!!!!!!
+#        end
+#      end
+#    end
+#
+#  end
+end
+
+context '!!!!!!!!!!! LEAKING !!!!!!!!!!!!!!!!!!' do
+  describe EventMachine, " when running failing examples" do
+    include AMQP::SpecHelper
+
+    it "should not bubble failures beyond rspec" do
+      amqp do
+        EM.add_timer(0.1) do
+          :should_not_bubble.should == :failures
+          done
+        end
+      end
+      AMQP.conn.should == nil
+    end
+
+    it "should not block on failure" do
+      1.should == 2
+    end
+  end
+
+  describe EventMachine, " when testing with AMQP::Spec with a maximum execution time per test" do
+
+    include AMQP::Spec
+
+    it 'should timeout before reaching done' do
+      EM.add_timer(2) {
+        done
+      }
+    end
+  end
+end
+
+
+describe "Rspec", " when running an example group after another group that uses AMQP-Spec " do
+  it "should work normally" do
+    :does_not_hang.should_not be_false
+  end
+end

data/spec/rspec_em_spec.rb

@@ -0,0 +1,67 @@
+require_relative 'spec_helper.rb'
+
+context 'Plain EM, no AMQP' do
+  describe EventMachine, " when testing with AMQP::SpecHelper" do
+    include AMQP::SpecHelper
+
+    it "should not require a call to done when #em is not used" do
+      1.should == 1
+    end
+
+    it "should have timers" do
+      em do
+        start = Time.now
+
+        EM.add_timer(0.5) {
+          (Time.now-start).should be_close(0.5, 0.1)
+          done
+        }
+      end
+    end
+  end
+
+  describe EventMachine, " when testing with AMQP::Spec" do
+    include AMQP::EMSpec
+
+    it 'should work' do
+      done
+    end
+
+    it 'should have timers' do
+      start = Time.now
+
+      EM.add_timer(0.5) {
+        (Time.now-start).should be_close(0.5, 0.1)
+        done
+      }
+    end
+
+    it 'should have periodic timers' do
+      num = 0
+      start = Time.now
+
+      timer = EM.add_periodic_timer(0.2) {
+        if (num += 1) == 2
+          (Time.now-start).should be_close(0.4, 0.1)
+          EM.__send__ :cancel_timer, timer
+          done
+        end
+      }
+    end
+
+    it 'should have deferrables' do
+      defr = EM::DefaultDeferrable.new
+      defr.timeout(0.5)
+      defr.errback {
+        done
+      }
+    end
+
+  end
+end
+
+describe "Rspec", " when running an example group after groups that uses EM specs " do
+  it "should work normally" do
+    :does_not_hang.should_not be_false
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--color
+--format nested

data/spec/spec_helper.rb

@@ -0,0 +1,35 @@
+#$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+$LOAD_PATH << "." unless $LOAD_PATH.include? "." # moronic 1.9.2 breaks things bad
+
+require 'spec'
+require 'yaml'
+
+require File.join(File.dirname(__FILE__), '..', 'lib', 'amqp-spec', 'rspec.rb')
+
+amqp_config = File.dirname(__FILE__) + '/amqp.yml'
+if File.exists? amqp_config
+
+  class Hash
+    def symbolize_keys
+      self.inject({}) { |result, (key, value)|
+        new_key = case key
+                    when String then
+                      key.to_sym
+                    else
+                      key
+                  end
+        new_value = case value
+                      when Hash then
+                        value.symbolize_keys
+                      else
+                        value
+                    end
+        result[new_key] = new_value
+        result
+      }
+    end
+  end
+
+  AMQP_OPTS = YAML::load_file(amqp_config).symbolize_keys[:test]
+end

data/tasks/common.rake

@@ -0,0 +1,18 @@
+#task :default => 'test:run'
+#task 'gem:release' => 'test:run'
+
+task :notes do
+ puts 'Output annotations (TBD)'
+end
+
+#Bundler not ready for prime time just yet
+#desc 'Bundle dependencies'
+#task :bundle do
+#  output = `bundle check 2>&1`
+#
+#  unless $?.to_i == 0
+#    puts output
+#    system "bundle install"
+#    puts
+#  end
+#end

data/tasks/doc.rake

@@ -0,0 +1,14 @@
+desc 'Alias to doc:rdoc'
+task :doc => 'doc:rdoc'
+
+namespace :doc do
+  require 'rake/rdoctask'
+  Rake::RDocTask.new do |rdoc|
+#    Rake::RDocTask.new(:rdoc => "rdoc", :clobber_rdoc => "clobber", :rerdoc => "rerdoc") do |rdoc|
+    rdoc.rdoc_dir = DOC_PATH.basename.to_s
+    rdoc.title = "#{NAME} #{VERSION} Documentation"
+    rdoc.main = "README.doc"
+    rdoc.rdoc_files.include('README*')
+    rdoc.rdoc_files.include('lib/**/*.rb')
+  end
+end

data/tasks/gem.rake

@@ -0,0 +1,40 @@
+desc "Alias to gem:release"
+task :release => 'gem:release'
+
+desc "Alias to gem:install"
+task :install => 'gem:install'
+
+desc "Alias to gem:build"
+task :gem => 'gem:build'
+
+namespace :gem do
+  gem_file = "#{NAME}-#{VERSION}.gem"
+
+  desc "(Re-)Build gem"
+  task :build do
+    puts "Remove existing gem package"
+    rm_rf PKG_PATH
+    puts "Build new gem package"
+    system "gem build #{NAME}.gemspec"
+    puts "Move built gem to package dir"
+    mkdir_p PKG_PATH
+    mv gem_file, PKG_PATH
+  end
+
+  desc "Cleanup already installed gem(s)"
+  task :cleanup do
+    puts "Cleaning up installed gem(s)"
+    system "gem cleanup #{NAME}"
+  end
+
+  desc "Build and install gem"
+  task :install => :build do
+    system "gem install #{PKG_PATH}/#{gem_file}"
+  end
+
+  desc "Build and push gem to Gemcutter"
+  task :release => [:build, 'git:tag'] do
+    puts "Pushing gem to Gemcutter"
+    system "gem push #{PKG_PATH}/#{gem_file}"
+  end
+end

data/tasks/git.rake

@@ -0,0 +1,34 @@
+desc "Alias to git:commit"
+task :git => 'git:commit'
+
+namespace :git do
+
+  desc "Stage and commit your work [with message]"
+  task :commit, [:message] do |t, args|
+    puts "Staging new (unversioned) files"
+    system "git add --all"
+    if args.message
+      puts "Committing with message: #{args.message}"
+      system %Q[git commit -a -m "#{args.message}" --author arvicco]
+    else
+      puts "Committing"
+      system %Q[git commit -a -m "No message" --author arvicco]
+    end
+  end
+
+  desc "Push local changes to Github"
+  task :push => :commit do
+    puts "Pushing local changes to remote"
+    system "git push"
+  end
+
+  desc "Create (release) tag on Github"
+  task :tag => :push do
+    tag = VERSION
+    puts "Creating git tag: #{tag}"
+    system %Q{git tag -a -m "Release tag #{tag}" #{tag}}
+    puts "Pushing #{tag} to remote"
+    system "git push origin #{tag}"
+  end
+
+end

data/tasks/spec.rake

@@ -0,0 +1,19 @@
+desc 'Alias to spec:spec'
+task :spec => 'spec:spec'
+
+namespace :spec do
+  require 'spec/rake/spectask'
+
+  desc "Run all specs"
+  Spec::Rake::SpecTask.new(:spec) do |t|
+    t.spec_opts = ['--options', %Q{"#{BASE_PATH}/spec/spec.opts"}]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+
+  desc "Run specs with RCov"
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+end

data/tasks/version.rake

@@ -0,0 +1,71 @@
+class Version
+  attr_accessor :major, :minor, :patch, :build
+
+  def initialize(version_string)
+    raise "Invalid version #{version_string}" unless version_string =~ /^(\d+)\.(\d+)\.(\d+)(?:\.(.*?))?$/
+    @major = $1.to_i
+    @minor = $2.to_i
+    @patch = $3.to_i
+    @build = $4
+  end
+
+  def bump_major(x)
+    @major += x.to_i
+    @minor = 0
+    @patch = 0
+    @build = nil
+  end
+
+  def bump_minor(x)
+    @minor += x.to_i
+    @patch = 0
+    @build = nil
+  end
+
+  def bump_patch(x)
+    @patch += x.to_i
+    @build = nil
+  end
+
+  def update(major, minor, patch, build=nil)
+    @major = major
+    @minor = minor
+    @patch = patch
+    @build = build
+  end
+
+  def write(desc = nil)
+    CLASS_NAME::VERSION_FILE.open('w') {|file| file.puts to_s }
+    (BASE_PATH + 'HISTORY').open('a') do |file|
+      file.puts "\n== #{to_s} / #{Time.now.strftime '%Y-%m-%d'}\n"
+      file.puts "\n* #{desc}\n" if desc
+    end
+  end
+
+  def to_s
+    [major, minor, patch, build].compact.join('.')
+  end
+end
+
+desc 'Set version: [x.y.z] - explicitly, [1/10/100] - bump major/minor/patch, [.build] - build'
+task :version, [:command, :desc] do |t, args|
+  version = Version.new(VERSION)
+  case args.command
+    when /^(\d+)\.(\d+)\.(\d+)(?:\.(.*?))?$/  # Set version explicitly
+      version.update($1, $2, $3, $4)
+    when /^\.(.*?)$/                        # Set build
+      version.build = $1
+    when /^(\d{1})$/                          # Bump patch
+      version.bump_patch $1
+    when /^(\d{1})0$/                         # Bump minor
+      version.bump_minor $1
+    when /^(\d{1})00$/                        # Bump major
+      version.bump_major $1
+    else                                      # Unknown command, just display VERSION
+      puts "#{NAME} #{version}"
+      next
+  end
+
+  puts "Writing version #{version} to VERSION file"
+  version.write args.desc
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: amqp-spec
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 4
+  version: 0.0.4
+platform: ruby
+authors: 
+- Arvicco
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-14 00:00:00 +04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+description: Simple API for writing (asynchronous) AMQP specs
+email: arvitallian@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- HISTORY
+- README.rdoc
+files: 
+- lib/amqp-spec/rspec.rb
+- lib/amqp-spec.rb
+- lib/version.rb
+- spec/amqp.yml
+- spec/failing_rspec_spec.rb
+- spec/rspec_amqp_spec.rb
+- spec/rspec_em_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/common.rake
+- tasks/doc.rake
+- tasks/gem.rake
+- tasks/git.rake
+- tasks/spec.rake
+- tasks/version.rake
+- Rakefile
+- README.rdoc
+- LICENSE
+- VERSION
+- HISTORY
+- .gitignore
+has_rdoc: true
+homepage: http://github.com/arvicco/amqp-spec
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset
+- UTF-8
+- --main
+- README.rdoc
+- --title
+- amqp-spec
+require_paths: 
+- lib
+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 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple API for writing (asynchronous) AMQP specs
+test_files: 
+- spec/amqp.yml
+- spec/failing_rspec_spec.rb
+- spec/rspec_amqp_spec.rb
+- spec/rspec_em_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb