danielsdeleo-em-spec 0.1.3

data/README.rdoc

@@ -0,0 +1,84 @@
+Simple BDD API for testing asynchronous Ruby/EventMachine code
+(c) 2008 Aman Gupta (tmm1)
+
+em-spec can be used with either bacon or rspec.
+
+=Rspec
+There are two ways to use the Rspec extension.  To use it as a helper, include EM::SpecHelper in your describe block.  You then use the em method to wrap your evented test code.  Inside the em block, you must call #done after your expectations.  Everything works normally otherwise.
+
+  require "em-spec/rspec"
+  describe EventMachine do
+    include EM::SpecHelper
+  
+    it "works normally when not using #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
+  end
+The other option is to include EM::Spec in your describe block.  This will patch Rspec so that all of your examples run inside an em block automatically:
+  require "em-spec/rspec"
+  describe EventMachine do
+    include EM::Spec
+    
+    it "requires a call to #done every time" do
+      1.should == 1
+      done
+    end
+    
+    it "runs test code in an em block automatically" do
+      start = Time.now
+
+      EM.add_timer(0.5){
+        (Time.now-start).should be_close( 0.5, 0.1 )
+        done
+      }
+    end
+  end
+
+=Bacon
+The API is identical to Bacon, except that you must explicitly call 'done' after all the current behavior's assertions have been made:
+
+  require 'em-spec/bacon'
+
+  EM.describe EventMachine do
+
+    should 'have timers' do
+      start = Time.now
+
+      EM.add_timer(0.5){
+        (Time.now-start).should.be.close 0.5, 0.1
+        done
+      }
+    end
+
+    should 'have periodic timers' do
+      num = 0
+      start = Time.now
+
+      timer = EM.add_periodic_timer(0.5){
+        if (num += 1) == 2
+          (Time.now-start).should.be.close 1.0, 0.1
+          EM.__send__ :cancel_timer, timer
+          done
+        end
+      }
+    end
+
+  end
+
+
+Resources:
+
+* Git repository: http://github.com/tmm1/em-spec
+* Bacon: http://groups.google.com/group/comp.lang.ruby/browse_thread/thread/30b07b651b0662fd
+* Initial announcement: http://groups.google.com/group/eventmachine/browse_thread/thread/8b4e7ead72f9d013

data/Rakefile

@@ -0,0 +1,18 @@
+task :gem => :gemspec do
+  sh 'gem build em-spec.gemspec'
+end
+
+task :gemspec do
+  
+end
+
+task :install => :gem do
+  sh 'sudo gem install em-spec-*.gem'
+end
+
+task :default => :gem
+
+task :spec do
+  sh 'bacon test/bacon_spec.rb'
+  sh 'spec -f specdoc test/rspec_spec.rb test/rspec_fail_examples.rb'
+end

data/lib/em-spec/bacon.rb

@@ -0,0 +1,65 @@
+require File.dirname(__FILE__) + '/../ext/fiber18'
+require 'rubygems'
+require 'eventmachine'
+
+module EventMachine
+  
+  def self.spec_backend=( backend )
+    @spec_backend = backend
+  end
+  
+  def self.spec_backend
+    @spec_backend
+  end
+  
+  def self.spec *args, &blk
+    raise ArgumentError, 'block required' unless block_given?
+    raise 'EventMachine reactor already running' if EM.reactor_running?
+
+    spec_backend.spec( args, blk )
+  end
+  class << self; alias :describe :spec; end
+
+  def self.bacon( *args, &block )
+    require File.dirname(__FILE__) + '/spec/bacon'
+    self.spec_backend = EventMachine::Spec::Bacon
+    self.spec( args, &block )
+  end
+
+end
+
+module EventMachine
+  module Spec
+    module Bacon
+      
+      def self.spec( args, blk )
+        EM.run do
+          ::Bacon.summary_on_exit
+          ($em_spec_fiber = Fiber.new{
+                              ::Bacon::FiberedContext.new(args.join(' '), &blk).run
+                              EM.stop_event_loop
+                            }).resume
+        end
+      end
+      
+    end
+  end
+end
+
+class Bacon::FiberedContext < Bacon::Context
+  def it *args
+    super{
+      if block_given?
+        yield
+        Fiber.yield
+      end
+    }
+  end
+
+  def done
+    EM.next_tick{
+      :done.should == :done
+      $em_spec_fiber.resume if $em_spec_fiber
+    }
+  end
+end

data/lib/em-spec/rspec.rb

@@ -0,0 +1,55 @@
+require 'eventmachine'
+require File.dirname(__FILE__) + '/../ext/fiber18'
+
+module EventMachine
+  module SpecHelper
+
+    def em(&block)
+
+      EM.run do
+        em_spec_exception = nil
+        @_em_spec_fiber = Fiber.new do
+          begin
+            block.call
+          rescue Exception => em_spec_exception
+            done
+          end
+          Fiber.yield
+        end  
+
+        @_em_spec_fiber.resume
+
+        raise em_spec_exception if em_spec_exception
+      end
+    end
+
+    def done
+      EM.next_tick{
+        finish_em_spec_fiber
+      }
+    end
+
+    private
+
+    def finish_em_spec_fiber
+      EM.stop_event_loop if EM.reactor_running?
+      @_em_spec_fiber.resume if @_em_spec_fiber.alive?
+    end
+
+  end
+  
+  module Spec
+
+    include SpecHelper
+
+    def instance_eval(&block)
+      em do
+        super(&block)
+      end
+    end
+
+  end
+  
+end
+
+

data/lib/ext/fiber18.rb

@@ -0,0 +1,81 @@
+# Poor Man's Fiber (API compatible Thread based Fiber implementation for Ruby 1.8)
+# (c) 2008 Aman Gupta (tmm1)
+
+unless defined? Fiber
+  require 'thread'
+
+  class FiberError < StandardError; end
+
+  class Fiber
+    def initialize
+      raise ArgumentError, 'new Fiber requires a block' unless block_given?
+
+      @yield = Queue.new
+      @resume = Queue.new
+
+      @thread = Thread.new{ @yield.push [ *yield(*@resume.pop) ] }
+      @thread.abort_on_exception = true
+      @thread[:fiber] = self
+    end
+    attr_reader :thread
+    
+    def alive?
+      @thread.alive?
+    end
+    
+    def resume *args
+      raise FiberError, 'dead fiber called' unless @thread.alive?
+      raise FiberError, 'double resume' if @thread == Thread.current
+      @resume.push(args)
+      result = @yield.pop
+      result.size > 1 ? result : result.first
+    end
+    
+    def resume!
+      @resume.push []
+    end
+    
+    def yield *args
+      @yield.push(args)
+      result = @resume.pop
+      result.size > 1 ? result : result.first
+    end
+    
+    def self.yield *args
+      raise FiberError, "can't yield from root fiber" unless fiber = Thread.current[:fiber]
+      fiber.yield(*args)
+    end
+
+    def self.current
+      Thread.current[:fiber] or raise FiberError, 'not inside a fiber'
+    end
+
+    def inspect
+      "#<#{self.class}:0x#{self.object_id.to_s(16)}>"
+    end
+  end
+else
+  require 'fiber'
+end
+
+if __FILE__ == $0
+  f = Fiber.new{ puts 'hi'; p Fiber.yield(1); puts 'bye'; :done }
+  p f.resume
+  p f.resume(2)
+end
+
+__END__
+
+$ ruby fbr.rb 
+hi
+1
+2
+bye
+:done
+
+$ ruby1.9 fbr.rb 
+hi
+1
+2
+bye
+:done

data/test/bacon_spec.rb

@@ -0,0 +1,51 @@
+require 'bacon'
+require File.dirname(__FILE__) + '/../lib/em-spec/bacon'
+
+EM.spec_backend = EventMachine::Spec::Bacon
+
+describe 'Bacon' do
+  should 'work as normal outside EM.describe' do
+    1.should == 1
+  end
+end
+
+EM.describe EventMachine do
+  should 'work' do
+    done
+  end
+
+  should 'have timers' do
+    start = Time.now
+
+    EM.add_timer(0.5){
+      (Time.now-start).should.be.close 0.5, 0.1
+      done
+    }
+  end
+
+  should 'have periodic timers' do
+    num = 0
+    start = Time.now
+
+    timer = EM.add_periodic_timer(0.5){
+      if (num += 1) == 2
+        (Time.now-start).should.be.close 1.0, 0.1
+        EM.__send__ :cancel_timer, timer
+        done
+      end
+    }
+  end
+
+  should 'have deferrables' do
+    defr = EM::DefaultDeferrable.new
+    defr.timeout(1)
+    defr.errback{
+      done
+    }
+  end
+
+  # it "should not block on failure" do
+  #   1.should == 2
+  # end
+
+end

data/test/rspec_fail_examples.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../lib/em-spec/rspec'
+
+describe EventMachine, "when running failing examples" do
+  include EM::Spec
+  
+  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

data/test/rspec_spec.rb

@@ -0,0 +1,71 @@
+require File.dirname(__FILE__) + '/../lib/em-spec/rspec'
+
+describe 'Rspec' do
+  it 'should work as normal outside EM.describe' do
+    1.should == 1
+  end
+end
+
+describe EventMachine, "when testing with EM::SpecHelper" do
+  include EM::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 EM::Spec" do
+  include EM::Spec
+  
+  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.5){
+      if (num += 1) == 2
+        (Time.now-start).should be_close( 1.0, 0.1 )
+        EM.__send__ :cancel_timer, timer
+        done
+      end
+    }
+  end
+
+  it 'should have deferrables' do
+    defr = EM::DefaultDeferrable.new
+    defr.timeout(1)
+    defr.errback{
+      done
+    }
+  end
+    
+end
+
+describe "Rspec", "when running an example group after another group that uses EMSpec " do
+  it "should work normally" do
+    :does_not_hang.should_not be_false
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: danielsdeleo-em-spec
+version: !ruby/object:Gem::Version 
+  version: 0.1.3
+platform: ruby
+authors: 
+- Aman Gupta
+- "Lourens Naud\xC3\xA9"
+- Daniel DeLeo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-20 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.6
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: bacon
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.12
+    version: 
+description: Rspec and Bacon based BDD API for Ruby/EventMachine
+email: em-spec@tmm1.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- Rakefile
+- lib/em-spec/bacon.rb
+- lib/em-spec/rspec.rb
+- lib/ext/fiber18.rb
+- test/bacon_spec.rb
+- test/rspec_spec.rb
+- test/rspec_fail_examples.rb
+has_rdoc: false
+homepage: http://github.com/tmm1/em-spec
+post_install_message: 
+rdoc_options: []
+
+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: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Bacon based BDD API for Ruby/EventMachine
+test_files: []
+