rspec_around_all 0.1.1

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2012-2013 Myron Marston
+
+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.md

@@ -0,0 +1,45 @@
+# RSpec Around All
+
+Provides around(:all) hooks for RSpec.
+
+## Usage
+
+In your Gemfile:
+
+``` ruby
+gem 'rspec_around_all', git: 'git://gist.github.com/2005175.git'
+```
+
+In a spec:
+
+``` ruby
+require 'rspec_around_all'
+
+describe "MyClass" do
+  around(:all) do |group|
+    # do something before
+    group.run_examples
+    # do something after
+  end
+
+  # or...
+  around(:all) do |group|
+    transactionally(&group)
+  end
+end
+```
+
+See also the original [blog post](http://myronmars.to/n/dev-blog/2012/03/building-an-around-hook-using-fibers) about this.
+
+## Contributing
+
+* Fork the project
+* Add tests
+* Fix the issue / add the feature
+* Submit pull request on github
+
+## Copyright
+
+Copyright (c) 2012-2013 Myron Marston. Released under the terms of the
+MIT license. See LICENSE for details.
+

data/lib/rspec_around_all.rb

@@ -0,0 +1,34 @@
+require 'delegate'
+require 'fiber'
+
+module RSpecAroundAll
+  class FiberAwareGroup < SimpleDelegator
+    def run_examples
+      Fiber.yield
+    end
+
+    def to_proc
+      proc { run_examples }
+    end
+  end
+
+  def around(scope = :each, &block)
+    # let RSpec handle around(:each) hooks...
+    return super(scope, &block) unless scope == :all
+
+    group, fiber = self, nil
+    before(:all) do
+      fiber = Fiber.new(&block)
+      fiber.resume(FiberAwareGroup.new(group))
+    end
+
+    after(:all) do
+      fiber.resume
+    end
+  end
+end
+
+RSpec.configure do |c|
+  c.extend RSpecAroundAll
+end
+

data/spec/rspec_around_all_spec.rb

@@ -0,0 +1,94 @@
+require_relative '../lib/rspec_around_all'
+
+module RSpec
+  module Core
+    describe "around(:all) hook" do
+      it "runs the hook around all examples" do
+        order = []
+
+        group = ExampleGroup.describe "group" do
+          around(:all) do |g|
+            order << :before
+            g.run_examples
+            order << :after
+          end
+          specify { order << :e1 }
+          specify { order << :e2 }
+        end
+
+        group.run(double.as_null_object)
+        order.should eq([:before, :e1, :e2, :after])
+      end
+
+      it 'allows the yielded arg to be treated as a proc' do
+        group = ExampleGroup.describe "group" do
+          def self.order
+            @order ||= []
+          end
+
+          def self.transactionally
+            order << :before
+            yield
+            order << :after
+          end
+
+          around(:all) { |g| transactionally(&g) }
+          specify { self.class.order << :e1 }
+          specify { self.class.order << :e2 }
+        end
+
+        group.run(double.as_null_object)
+        group.order.should eq([:before, :e1, :e2, :after])
+      end
+
+      it 'can access metadata in the hook' do
+        foo_value = nil
+        group = ExampleGroup.describe "group", :foo => :bar do
+          around(:all) do |group|
+            foo_value = group.metadata[:foo]
+            group.run_examples
+          end
+          specify { }
+        end
+
+        group.run(double.as_null_object)
+        foo_value.should eq(:bar)
+      end
+
+      it 'allows around(:each) hooks to run as normal' do
+        order = []
+
+        group = ExampleGroup.describe "group" do
+          around(:each) do |e|
+            order << :before
+            e.run
+            order << :after
+          end
+          specify { order << :e1 }
+          specify { order << :e2 }
+        end
+
+        group.run(double.as_null_object)
+        order.should eq([:before, :e1, :after, :before, :e2, :after])
+      end
+
+      it 'allows around hooks with no scope argument to run as normal' do
+        order = []
+
+        group = ExampleGroup.describe "group" do
+          around do |e|
+            order << :before
+            e.run
+            order << :after
+          end
+          specify { order << :e1 }
+          specify { order << :e2 }
+        end
+
+        group.run(double.as_null_object)
+        order.should eq([:before, :e1, :after, :before, :e2, :after])
+      end
+    end
+  end
+end
+

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: rspec_around_all
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Myron Marston
+- Sean Walbran
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: 
+email: seanwalbran@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/rspec_around_all.rb
+- LICENSE
+- README.md
+- spec/rspec_around_all_spec.rb
+homepage: https://github.com/seanwalbran/rspec_around_all
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Provides around(:all) hook for RSpec
+test_files:
+- spec/rspec_around_all_spec.rb