em-rspec 0.1 → 0.1.1

data/README.md

@@ -0,0 +1,37 @@
+# em-rspec
+
+em-rspec is a very simple patch to RSpec 2 that sets up and tears down an EventMachine reactor loop, and runs each example within the context of the loop. 
+It also will wrap each example in a [Fiber](http://ruby-doc.org/core-1.9/classes/Fiber.html) so you are free to untangle nested callbacks.
+
+# Usage
+
+`gem install em-rspec`
+
+`require 'em-rspec'`
+
+em-rspec extends RSpec in an unobtrusive way that requires no addtional code in your specs to test EM code. e.g.
+
+<pre>describe 'em-rspec' do
+  it 'executes specs within a reactor loop' do
+    EM.reactor_running?.should be_true # This is true
+  end
+end</pre>
+
+# How it works
+
+As mentioned before, before the spec is run, a reactor loop is setup, and a callback to teardown the loop when your example finishes execution is created.
+This is an important point to consider because if you do any asynchronous i/o operations, your code will not be tested, because your code will likely have
+finished execution before the i/o operation is complete. It is an antipattern to actually hit the network in your tests and what you should do is mock out
+i/o calls to return immediately, e.g. http calls with [webmock](https://github.com/bblimke/webmock).
+
+This is how your examples are run with em-rspec:
+
+- Set up reactor loop
+- Set callback to tear down reactor loop when spec is finished
+- Wrap example in fiber
+- Run before each block
+- Run example
+- Run after each block
+- Tear down reactor loop
+
+&copy; 2011 Stevie Graham

data/lib/patch.rb

@@ -12,8 +12,10 @@ RSpec::Core::Example.class_eval do
   def run(example_group_instance, reporter)
     Fiber.new do
       EM.run do
-        EM.next_tick { EM.stop }
+        df = EM::DefaultDeferrable.new
+        df.callback { |x| EM.stop }
         ignorant_run example_group_instance, reporter
+        df.succeed
       end
     end.resume
   end

metadata

@@ -1,79 +1,70 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: em-rspec
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.1.1
   prerelease: 
-  version: "0.1"
 platform: ruby
-authors: 
+authors:
 - Stevie Graham
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-07-25 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-07-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: eventmachine
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70187642950260 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.12.10
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *70187642950260
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70187642949580 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 2.5.0
   type: :development
-  version_requirements: *id002
-description: "Test EventMachine code in RSpec 2 "
+  prerelease: false
+  version_requirements: *70187642949580
+description: ! 'Test EventMachine code in RSpec 2 '
 email: sjtgraham@mac.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - README.md
 - lib/em-rspec.rb
 - lib/patch.rb
-has_rdoc: true
 homepage: http://github.com/stevegraham/em-rspec
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
       version: 1.9.1
-required_rubygems_version: !ruby/object:Gem::Requirement 
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.5.2
+rubygems_version: 1.8.16
 signing_key: 
 specification_version: 3
 summary: Test EventMachine code in RSpec 2
 test_files: []
-
+has_rdoc: