rutabaga 1.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 547b7485f528f7252565c2bec92ffe22494f08c9
-  data.tar.gz: 6584d74700984a895c43316e4b51ae863cc6f4ac
+  metadata.gz: 23d4ee4fca4ba9cc50f66acd809b29a67241567e
+  data.tar.gz: f35a01a98cc5df69b2207bb5d35d35f75ab1fb71
 SHA512:
-  metadata.gz: 4583d3ed0b60b7cb05f6ed17894ec833cb1b8dde9671880be2dc44cb8075c948dfa119112a282ef85b75c93927195daaac64b407afbb456b5ee591159c41dbae
-  data.tar.gz: 5fe7c7f08763cf41a28eff3a78937cc2caac4d8344fbe5415b87b7e99174afdef47b81b447503ee48c1188b6af76c3a948a39267937c4cbc7fc160651b0c7d70
+  metadata.gz: a0f89ac99d40a51f25b51d35a7a4313aa24804fc7e0a6fadb5160370392e134039220e56c9385373497f1cc9f120304f8e756b7ccf4a2c0b82087995ddb7ba58
+  data.tar.gz: 3fc0d2e7d30939fd5e44a2890ffa431f98f05e9481bfe11ded7bae5e9030247f480b48872ce6bfc5724a6f7196b19fd30d095fe93d734b68193e7627bd7b6bab

data/.travis.yml

@@ -3,9 +3,9 @@ rvm:
   - 2.0.0
   - 2.1.7
   - 2.2.3
-  - jruby-19mode
+  - jruby-9.0.5.0
 
 gemfile:
   - Gemfile
 
-script: bundle exec rspec spec
+script: bundle exec rspec spec

data/CHANGELOG.md

@@ -1,6 +1,38 @@
 # Changes
 
+## Version 2.0.0
+
+- Features should now be called directly in the describe block rather than inside an `it` block. This allows specific scenarios to be run without having to run the entire feature.
+
+Old:
+
+```ruby
+describe "the feature" do
+  it "runs the feature" do
+    feature
+  end
+
+  step "first step" do
+    ...
+  end
+end
+```
+
+New:
+
+```ruby
+feature "the feature" do
+  step "first step" do
+    ...
+  end
+end
+```
+
+The old way is deprecated.
+- Refactor of Turnip and RSpec integration to simplify
+- Improved feature finding, allowing features in the current directory to be found without specifying full path
+
 ## Version 1.0.0
 
 - Drop support for turnip versions less than 2.
-- Drop support (because of turnip) for rspec versions less than 3.
+- Drop support (because of turnip) for rspec versions less than 3.

data/Gemfile

@@ -3,3 +3,9 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in rutabaga.gemspec
 gemspec
 
+unless RUBY_PLATFORM
+  gem 'pry-byebug'
+  gem 'pry-doc'
+  gem 'pry-stack_explorer'
+  gem 'pry-rescue'
+end

data/README.md

@@ -1,5 +1,7 @@
 # Rutabaga
 
+![image](rutabaga-vs-turnip.jpg)
+
 [Turnip](https://github.com/jnicklas/turnip) hacks to enable running turnips from inside spec files, rather than outside.
 
 Rutabaga allows you to invert the control of feature files, so that features are called from your `_spec.rb` files rather than the other way around. Step definitions are then put into the `_spec.rb` files as well. The steps are then scoped to that particular test.
@@ -7,6 +9,7 @@ Rutabaga allows you to invert the control of feature files, so that features are
 This means that it is simple to create tests that are described by a class (such as controller tests in rspec-rails).
 
 [![Build Status](https://travis-ci.org/simplybusiness/rutabaga.svg?branch=master)](https://travis-ci.org/simplybusiness/rutabaga)
+[![Gem Version](https://badge.fury.io/rb/rutabaga.svg)](https://badge.fury.io/rb/rutabaga)
 
 ## Installation
 
@@ -53,19 +56,17 @@ end
 
 ### Running a feature file from a spec file
 
-Please look in `spec/controllers/feature_test_spec.rb` and `spec/controllers/feature_test.feature` for more.
-
-For file `spec/controllers/test_feature_spec.rb`
+If you create a file `spec/controllers/test_feature_spec.rb` and add:
 
 ```ruby
-it "should run feature" do
-  feature
+feature "should run feature" do
+
 end
 ```
 
-Will run `spec/controllers/test_feature.feature`.
+Rutabaga will run `spec/controllers/test_feature.feature`.
 
-Features are found either with the same name as the spec file, or as specified in the example name `it "relative_from_root/path/to/feature/file.feature"`. So, if you have:
+Features are found either with the same name as the spec file, or as specified by the feature `feature "relative_from_root/path/to/feature/file.feature"`. So, if you have:
 
 `spec/controllers/feature_test_spec.rb`
 
@@ -73,45 +74,41 @@ Then the feature will be:
 
 `spec/controllers/feature_test.feature`
 
-Alternatively, if the feature is specified in the `it`, that takes precedence:
+Alternatively, if the feature is specified in the `feature`, that takes precedence:
 
 ```ruby
-it "spec/features/test.feature" do
-    feature
+feature "spec/features/test.feature" do
+
 end
 ```
 
-Will run `spec/features/test.feature`.
-
-Second alternative, is specifying the feature file in the `feature` command:
+Path can also be relative to the spec location so:
 
 ```ruby
-it "should run the feature" do
-    feature "spec/features/test.feature"
+feature "test.feature" do
+
 end
 ```
 
-Will run `spec/features/test.feature`.
+Will run `spec/controllers/test.feature`.
+
+**Note** Anywhere that a `.feature` extension can be used, a `.rutabaga` extension is also valid.
 
 ### Definining steps
 
 Steps are defined in the same way as in Turnip, however, steps can be defined within the rspec context and are scoped to only be available there.
 
 ```ruby
-describe "step will only be in this context" do
-  it "should run feature" do
-    feature
-  end
+feature "step will only be in this context" do
 
   step "action :named" do |named| do
     expect(named).to eq("a name")
   end
 end
 
-describe "step 'action :named' is not available here" do
-  it "cannot run feature due to missing step" do
-    expect(feature).to raise_error
-  end
+feature "step 'action :named' is not available here" do
+
+  # missing step will cause tests to be marked as pending"
 end
 ```
 
@@ -127,15 +124,18 @@ Other than these differences, Rutabaga is a tiny shim over Turnip and all featur
 * Test those rules whereever/however appropriate (not just through Capybara/black box)
 * Use the full power of RSpec (so being able to describe a class and then test it)
 
-From my point of view, the fundamental purpose of Turnip/Cucumber is to document the system in end-user readable form. It is not just to do integration tests.
-
 The most important functionality in a system is the business rules. These range from what appears on a page, to complex rules around when emails should be sent to who. For example, we've written Gherkin tests to test premium changes when a customer changes their insurance coverage.
 
 These rules are often implemented in a Model, a lib class, or some other specific class in the system, especially if the application is well modularized.
 
-In any case, business rules are usually implemented somewhere inside a class tested by a unit test. I want to get those business rules tested in Cucumber/Turnip without having to go through the whole system, and without having to have duplicate tests, one inside my rspec and another inside my features.
+In any case, business rules are usually implemented somewhere inside a class tested by a unit test. Those business rules should be tested in Cucumber/Turnip without having to go through the whole system, and without having to have duplicate tests, one inside rspec and another inside features.
+
+The goal is to test just the business rule, in Rutabaga, and not the login, the html, the steps to get there, etc. That way, when the rule changes, only the feature, the test code and the class in question need to change. The test is not affected by wider ranging changes, and is therefore less brittle. The features run at the unit code level, but are acceptance tests.
+
+## Notes/Issues
 
-My goal is to test just the business rule, in Turnip, and not the login, the html, the steps to get there, etc. That way, when the rule changes, I change the Turnip, the test code and the class in question. My test is not affected by wider ranging changes, and therefore less brittle. I guess, in that sense, the code runs at the unit code level, but is an acceptance test.
+1. Capybara's rspec extension also redefines feature, so rutabaga will block capaybara's feature example groups
+   from working.
 
 ## Contributing
 
@@ -157,9 +157,9 @@ Put the following (example in a `Gemfile_for_xxx`) to test other versions of gem
 # Use global Gemfile and customize
 eval(IO.read('Gemfile'), binding)
 
-gem 'turnip', '1.2.4'
+gem 'turnip', '1.3.1'
 ```
 
 ## Copyright
 
-Copyright © 2012-2015 Simply Business. See LICENSE for details.
+Copyright © 2012-2016 Simply Business. See LICENSE for details.

data/examples/compatibility/compatibility_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'capybara/rspec'
+
+describe "capaybara rails does not overwrite the feature command" do
+  feature '../test2.feature' do
+    step "that :first + :second is calculated" do |first, second|
+      @first = first
+      @second = second
+    end
+
+    step "my result is :result" do |result|
+      expect(@first.to_i + @second.to_i - 1).to eq(result.to_i)
+    end
+  end
+end
+
+describe "turnip doesn't overwrite the type", type: :parent_group do
+  feature '../test2.feature' do
+    step "that :first + :second is calculated" do |first, second|
+      metadata_type = RSpec.current_example.example_group.metadata[:type]
+
+      puts "feature metadata type is preserved as #{metadata_type}"
+
+      expect(metadata_type).to eq(:parent_group)
+    end
+
+    step "my result is :result" do |result|
+    end
+  end
+end

data/examples/test.feature

@@ -3,3 +3,13 @@ Feature: Test that rspec will call the feature
 Scenario: ensures the feature is called
 Given that 2 + 2 is calculated
 Then my result is 4
+
+Scenario Outline: ensures the outline feature is called
+Given that <a> + <b> is calculated
+Then my result is <c>
+
+Examples:
+| a | b | c  |
+| 1 | 1 | 2  |
+| 2 | 2 | 4  |
+| 3 | 3 | 5  |

data/examples/test_feature_example_group.feature

@@ -0,0 +1,15 @@
+Feature: Test that rspec will call the feature
+
+Scenario: ensures the feature is called
+Given that 2 + 2 is calculated
+Then my result is 4
+
+Scenario Outline: ensures the outline feature is called with one failing example which can be called individually
+Given that <a> + <b> is calculated
+Then my result is <c>
+
+Examples:
+| a | b | c  |
+| 1 | 1 | 2  |
+| 2 | 2 | 4  |
+| 3 | 3 | 5  |

data/examples/test_feature_example_group_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+
+describe "test feature argument" do
+  feature
+
+  step "that :first + :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i + @second.to_i).to eq(result.to_i)
+  end
+end
+
+feature "feature block" do
+  step "that :first + :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i + @second.to_i).to eq(result.to_i)
+  end
+end
+
+describe "feature block inside a describe block" do
+  feature do
+
+    step "that :first + :second is calculated" do |first, second|
+      @first = first
+      @second = second
+    end
+
+    step "my result is :result" do |result|
+      expect(@first.to_i + @second.to_i).to eq(result.to_i)
+    end
+  end
+end
+
+describe "should find the feature file using the root (and monkey patching the result)" do
+  feature "examples/test2.feature"
+
+  step "that :first + :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i + @second.to_i - 1).to eq(result.to_i)
+  end
+end
+
+describe "causes a failing test" do
+  feature "examples/test2.feature"
+
+  step "that :first + :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i + @second.to_i).to eq(result.to_i)
+  end
+end
+
+describe "finds a feature file given as parameter to the 'feature' method" do
+  feature "examples/test3.feature"
+
+  step "that :first * :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i * @second.to_i).to eq(result.to_i)
+  end
+end
+
+describe "finds a feature file with a different name in the same directory" do
+  feature "test3.feature"
+
+  step "that :first * :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@first.to_i * @second.to_i).to eq(result.to_i)
+  end
+end
+
+describe "backgrounds are properly called" do
+  feature "examples/test_background.feature"
+
+  step "we add :initial" do |initial|
+    @initial = 10
+  end
+
+  step "that :first * :second is calculated" do |first, second|
+    @first = first
+    @second = second
+  end
+
+  step "my result is :result" do |result|
+    expect(@initial.to_i + @first.to_i * @second.to_i).to eq(result.to_i)
+  end
+
+end

data/examples/test_spec.rb

@@ -1,20 +1,5 @@
 require 'spec_helper'
 
-describe "test" do
-  it "should run feature" do
-    feature
-  end
-
-  step "that :first + :second is calculated" do |first, second|
-    @first = first
-    @second = second
-  end
-
-  step "my result is :result" do |result|
-    expect(@first.to_i + @second.to_i).to eq(result.to_i)
-  end
-end
-
 describe "should find the feature file using the root (and monkey patching the result)" do
   it "examples/test2.feature" do
     feature
@@ -30,55 +15,3 @@ describe "should find the feature file using the root (and monkey patching the r
   end
 
 end
-
-describe "causes a failing test" do
-  it "examples/test2.feature" do
-    feature
-  end
-
-  step "that :first + :second is calculated" do |first, second|
-    @first = first
-    @second = second
-  end
-
-  step "my result is :result" do |result|
-    expect(@first.to_i + @second.to_i).to eq(result.to_i)
-  end
-
-end
-
-describe "finds a feature file given as parameter to the 'feature' method" do
-  it "implements the named feature" do
-    feature "examples/test3.feature"
-  end
-
-  step "that :first * :second is calculated" do |first, second|
-    @first = first
-    @second = second
-  end
-
-  step "my result is :result" do |result|
-    expect(@first.to_i * @second.to_i).to eq(result.to_i)
-  end
-
-end
-
-describe "backgrounds are properly called" do
-  it "implements the named feature" do
-    feature "examples/test_background.feature"
-  end
-
-  step "we add :initial" do |initial|
-    @initial = 10
-  end
-
-  step "that :first * :second is calculated" do |first, second|
-    @first = first
-    @second = second
-  end
-
-  step "my result is :result" do |result|
-    expect(@initial.to_i + @first.to_i * @second.to_i).to eq(result.to_i)
-  end
-
-end

data/lib/rutabaga.rb

@@ -1,3 +1,6 @@
 require 'rutabaga/version'
+require 'active_support/concern'
 require 'turnip'
 require 'rutabaga/feature'
+require 'rutabaga/example_group/feature'
+require 'rutabaga/util'

data/lib/rutabaga/example_group/feature.rb

@@ -0,0 +1,45 @@
+require 'turnip/rspec'
+require 'rspec'
+
+# Monkey patch rspec to block capybara from using feature
+class RSpec::Core::Configuration
+  alias_method :orig_alias_example_group_to, :alias_example_group_to
+
+  def alias_example_group_to(new_name, *args)
+    return if [:feature, :xfeature, :ffeature].include?(new_name)
+    orig_alias_example_group_to(new_name, *args)
+  end
+end
+
+# Monkey patch RSpec to add the feature method in example groups
+class RSpec::Core::ExampleGroup
+  class << self
+    alias_method :orig_subclass, :subclass
+
+    def subclass(parent, description, args, &example_group_block)
+      self.orig_subclass(parent, description, args, &example_group_block).tap do |describe|
+
+        if args.any? { |arg| arg.kind_of?(Hash) && arg[:rutabaga] }
+          Rutabaga::ExampleGroup::Feature.feature(describe, description, args)
+        end
+
+      end
+    end
+  end
+
+  define_example_group_method :feature, :rutabaga => true
+end
+
+module Rutabaga
+  module ExampleGroup
+    module Feature
+      class << self
+        def feature(example_group_class, description, args)
+          Util.require_if_exists 'turnip_helper'
+
+          Turnip::RSpec.rutabaga_run(Util.find_feature(description), example_group_class)
+        end
+      end
+    end
+  end
+end

data/lib/rutabaga/feature.rb

@@ -3,8 +3,15 @@ require 'rspec'
 
 module Rutabaga
   module Feature
-    def feature(feature_file = find_feature)
-
+    def feature(feature_file = nil)
+      RSpec.deprecate(
+        "Calling `feature` from an `it` block",
+        :message => "Calling `feature` from an `it` block " \
+                    "is deprecated.\nIt should now be called directly in the " \
+                    "`describe` block."
+      )
+
+      feature_file = Util.find_feature(feature_file || RSpec.current_example.description)
       example_group_class = self.class
 
       # Hack turnip into the rspec only when needed
@@ -14,20 +21,7 @@ module Rutabaga
       run(feature_file, example_group_class)
     end
 
-    def find_feature
-      return get_example.description if File.exists?(get_example.description)
-
-      feature_file = caller(0).find do |call|
-        call =~ /_spec.rb:/
-      end.gsub(/_spec.rb:.*\Z/, '.feature')
-      return feature_file if File.exists?(feature_file)
-
-      raise "Feature file not found. Tried: #{get_example.description} and #{feature_file}"
-    end
-
-    private
-
-    # Adapted from jnicklas/turnip v1.3.1
+    # Adapted from jnicklas/turnip v2.0.0
     def run(feature_file, example_group_class)
       Turnip::Builder.build(feature_file).features.each do |feature|
         describe = example_group_class.describe feature.name, feature.metadata_hash
@@ -38,7 +32,7 @@ module Rutabaga
     def run_feature(describe, feature, filename, example_group_class)
       example_group_class.before do
         # This is kind of a hack, but it will make RSpec throw way nicer exceptions
-        get_example.metadata[:file_path] = filename
+        RSpec.current_example.metadata[:file_path] = filename
 
         feature.backgrounds.map(&:steps).flatten.each do |step|
           run_step(filename, step)
@@ -55,15 +49,5 @@ module Rutabaga
         end
       end
     end
-
-    def get_example
-      @example ||= RSpec.current_example
-    end
   end
 end
-
-::RSpec.configure do |c|
-  c.include Rutabaga::Feature
-  # Blow away turnip's pattern, and focus just on features directory
-  c.pattern.gsub!(",**/*.feature", ",features/**/*.feature")
-end

data/lib/rutabaga/util.rb

@@ -0,0 +1,68 @@
+# Utils and monkey patches for both versions of feature
+
+# Monkey patch for Turnip to not have to copy loads of code
+module Turnip::RSpec
+  def self.rutabaga_run(feature_file, example_group_class)
+    Turnip::Builder.build(feature_file).features.each do |feature|
+      instance_eval <<-EOS, feature_file, feature.line
+        describe = example_group_class.describe feature.name, feature.metadata_hash.reject { |key, _| key == :type }
+        run_feature(describe, feature, feature_file)
+      EOS
+    end
+  end
+end
+
+module Rutabaga
+  class Util
+    class << self
+      def find_feature(description)
+        tried = []
+
+        if description =~ /.*\.(feature|rutabaga)\Z/
+          return description if File.exists?(description)
+          tried << description
+
+          candidate = File.join(extract_directory, description)
+          return candidate if File.exists?(candidate)
+          tried << candidate
+        else
+          feature_files = extract_features
+          feature_files.each do |feature_file|
+            return feature_file if File.exists?(feature_file)
+          end
+          tried += feature_files
+        end
+
+        raise "Feature file not found. Tried: #{tried.join(', ')}"
+      end
+
+      def require_if_exists(filename)
+        require filename
+      rescue LoadError => e
+        # Don't hide LoadErrors raised in the spec helper.
+        raise unless e.message.include?(filename)
+      end
+
+      private
+
+      def extract_directory
+        caller(0).find do |call|
+          call =~ /_spec.rb:/
+        end.gsub(/\/[^\/]+_spec.rb:.*\Z/, '')
+      end
+
+      def extract_features
+        base = caller(0).find do |call|
+          call =~ /_spec.rb:/
+        end.gsub(/_spec.rb:.*\Z/, '')
+        [base+'.feature', base+'.rutabaga']
+      end
+    end
+  end
+end
+
+::RSpec.configure do |c|
+  c.include Rutabaga::Feature
+  # Blow away turnip's pattern, and focus just on features directory
+  c.pattern.gsub!(",**/*.feature", ",features/**/*.feature")
+end

data/lib/rutabaga/version.rb

@@ -1,3 +1,3 @@
 module Rutabaga
-  VERSION = '1.0.0'
+  VERSION = '2.0.1'
 end

data/rutabaga.gemspec

@@ -16,6 +16,11 @@ Gem::Specification.new do |gem|
   gem.version       = Rutabaga::VERSION
   gem.license       = 'MIT'
 
-  gem.add_runtime_dependency 'turnip', ['>= 2.0']
-  gem.add_development_dependency "pry", '~> 0'
+  gem.add_runtime_dependency 'turnip', ['~> 2.0.0']
+  gem.add_runtime_dependency 'gherkin', ['~> 2.0']
+  gem.add_runtime_dependency 'activesupport'
+  # There is a bug in 3.4.1 with turnip 2.0.x
+  gem.add_runtime_dependency 'rspec-mocks', ['<= 3.4.0']
+  gem.add_development_dependency 'capybara'
+  gem.add_development_dependency 'pry', '~> 0'
 end

data/spec/feature_spec.rb

@@ -1,36 +1,76 @@
 require 'spec_helper'
 
 describe 'integration', :type => :integration do
-  before do
-    @result = %x(rspec -r rutabaga -fd examples/*_spec.rb)
-  end
+  describe 'functionality' do
+    before(:all) do
+      @result = %x(rspec -r rutabaga -fd examples/*_spec.rb 2>&1)
+    end
 
-  it "shows the correct description" do
-    expect(@result).to include('ensures the feature is called')
-    expect(@result).to include('that 2 + 2 is calculated')
-    expect(@result).to include('my result is 4')
-  end
+    it "shows the correct description" do
+      expect(@result).to include('ensures the feature is called')
+      expect(@result).to include('that 2 + 2 is calculated')
+      expect(@result).to include('my result is 4')
+    end
 
-  it "should not show any pending steps" do
-    expect(@result).not_to include('PENDING')
-    expect(@result).not_to include('No such step')
-  end
+    it "executes features as an argument" do
+      expect(@result).to include('test feature argument')
+    end
 
-  it "prints out failures and successes" do
-    expect(@result).to include('10 examples, 1 failure')
-  end
+    it "executes features as blocks/example groups" do
+      expect(@result).to include('feature block')
+    end
 
-  it "should find features relative to the root" do
-    expect(@result).not_to include('Feature file not found')
-  end
+    it "executes features as blocks inside example groups" do
+      expect(@result).to include('feature block inside a describe block')
+    end
 
-  it "finds the .feature file given as parameter to the 'feature' method" do
-    expect(@result).to include('that 2 * 4 is calculated')
-    expect(@result).to include('my result is 8')
-  end
+    it "should not show any pending steps" do
+      expect(@result).not_to include('PENDING')
+      expect(@result).not_to include('No such step')
+    end
+
+    it "prints out failures and successes" do
+      expect(@result).to include('19 examples, 4 failures')
+    end
+
+    it "should find features relative to the root" do
+      expect(@result).not_to include('Feature file not found')
+    end
 
-  it "should scope steps to describe blocks" do
-    expect(@result).not_to include('Turnip::Ambiguous')
+    it "finds the .feature file given as parameter to the 'feature' method" do
+      expect(@result).to include('that 2 * 4 is calculated')
+      expect(@result).to include('my result is 8')
+    end
+
+    it "should scope steps to describe blocks" do
+      expect(@result).not_to include('Turnip::Ambiguous')
+    end
+
+    it "should provide failure messages that allow a specific scenario to be run" do
+      expect(@result).to include("rspec ./examples/test_feature_example_group_spec.rb[1:1:1:4:1]")
+    end
+
+    it "should have a feature deprecation warning" do
+      expect(@result).to include("Calling `feature` from an `it` block is deprecated.")
+    end
   end
 
+  describe 'compatibility' do
+    before(:all) do
+      @result = %x(rspec -r rutabaga -fd examples/compatibility/*_spec.rb 2>&1)
+    end
+
+    it "passes all tests" do
+      expect(@result).to include('2 examples, 0 failures')
+    end
+
+    it "runs feature blocks even if capybara/rspec is installed" do
+      expect(@result).to include("capaybara rails does not overwrite the feature command")
+    end
+
+    it "preserves the type from the surrounding describe blocks (for example rspec rails example groups)" do
+      expect(@result).to include("feature metadata type is preserved as parent_group")
+    end
+
+  end
 end

data/spec/rutabaga/util_spec.rb

@@ -0,0 +1,130 @@
+require 'spec_helper'
+require 'rutabaga'
+
+describe Rutabaga::Util do
+  describe "location of test from stack track" do
+    it "finds the directory" do
+      expect(subject.class.send(:extract_directory)).to match(/\/rutabaga\/spec\/rutabaga\Z/)
+    end
+
+    it "finds the feature" do
+      features = subject.class.send(:extract_features)
+      expect(features[0]).to match(/\/rutabaga\/spec\/rutabaga\/util\.feature\Z/)
+      expect(features[1]).to match(/\/rutabaga\/spec\/rutabaga\/util\.rutabaga\Z/)
+    end
+  end
+
+  describe ".find_feature" do
+    let(:subject) { Rutabaga::Util.find_feature(@description) }
+    before do
+      allow(File).to receive(:exists?).with('spec/rutabaga/existing.feature').and_return(true)
+      allow(File).to receive(:exists?).with('spec/rutabaga/missing.feature').and_return(false)
+      allow(File).to receive(:exists?).with(nil).and_return(false)
+    end
+
+    it "returns the file if it exists" do
+      @description = 'spec/rutabaga/existing.feature'
+      expect(subject).to eq('spec/rutabaga/existing.feature')
+    end
+
+    describe "looks for the feature in the spec's directory" do
+      before do
+        allow(File).to receive(:exists?).with('different.feature').and_return(false)
+      end
+
+      it "looks directly in the directory" do
+        @description = 'different.feature'
+        expect(File).to receive(:exists?).with(/spec\/rutabaga\/different\.feature\Z/).and_return(true)
+
+        expect(subject).to match(/spec\/rutabaga\/different\.feature\Z/)
+      end
+
+      it "allows sub-directories" do
+        allow(File).to receive(:exists?).with('subdirectory/different.feature').and_return(false)
+
+        @description = 'subdirectory/different.feature'
+        expect(File).to receive(:exists?).with(/spec\/rutabaga\/subdirectory\/different\.feature\Z/).and_return(true)
+
+        expect(subject).to match(/spec\/rutabaga\/subdirectory\/different\.feature\Z/)
+      end
+    end
+
+    describe "figures out the feature name from the spec name" do
+      it "description is nil" do
+        @description = nil
+        allow(File).to receive(:exists?).with(/spec\/rutabaga\/util\.feature\Z/).and_return(true)
+        expect(subject).to match(/spec\/rutabaga\/util\.feature\Z/)
+      end
+
+      it "description does not match a feature file" do
+        @description = 'this is not a feature file'
+        allow(File).to receive(:exists?).with(/this is not a feature file/).and_return(false)
+
+        allow(File).to receive(:exists?).with(/spec\/rutabaga\/util\.feature\Z/).and_return(true)
+        expect(subject).to match(/spec\/rutabaga\/util\.feature\Z/)
+      end
+
+      it "description does not match a feature file" do
+        @description = 'this is not a feature file'
+        allow(File).to receive(:exists?).with(/this is not a feature file/).and_return(false)
+
+        allow(File).to receive(:exists?).with(/spec\/rutabaga\/util\.feature\Z/).and_return(false)
+        allow(File).to receive(:exists?).with(/spec\/rutabaga\/util\.rutabaga\Z/).and_return(true)
+        expect(subject).to match(/spec\/rutabaga\/util\.rutabaga\Z/)
+      end
+
+      it "handles paths with spaces" do
+        @description = '/User/person/Internet plugins/feature.feature'
+        allow(File).to receive(:exists?).with(@description).and_return(true)
+
+        expect(subject).to eq(@description)
+      end
+
+      it "allows the .feature extension" do
+        @description = "example.feature"
+        allow(File).to receive(:exists?).with(@description).and_return(true)
+
+        expect(subject).to include(@description)
+      end
+
+      it "allows the .rutabaga extension" do
+        @description = "example.rutabaga"
+        allow(File).to receive(:exists?).with(@description).and_return(true)
+
+        expect(subject).to include(@description)
+      end
+
+    end
+
+    describe "raises an error if the feature cannot be found" do
+      before do
+        allow(File).to receive(:exists?).and_return(false)
+      end
+
+      it "has a nil description" do
+        @description = nil
+
+        expect{subject}.to raise_error(/Feature file not found\. Tried: [\\\/\w]*\/spec\/rutabaga\/util\.feature/)
+      end
+
+      it "has a sentance description" do
+        @description = "my life as a dog"
+
+        expect{subject}.to raise_error(/Feature file not found\. Tried: [\\\/\w]*\/spec\/rutabaga\/util\.feature/)
+      end
+
+      it "has a filename description but the file doesn't exist" do
+        @description = "example.feature"
+
+        expect{subject}.to raise_error(/Feature file not found\. Tried: example\.feature, [\\\/\w]*example\.feature/)
+      end
+
+      it "raises an error if the filename does not end in feature" do
+        @description = "example.other"
+        allow(File).to receive(:exists?).with(@description).and_return(true)
+
+        expect{subject}.to raise_error(/Feature file not found\. Tried: [\\\/\w]*\/spec\/rutabaga\/util\.feature/)
+      end
+    end
+  end
+end

metadata

@@ -1,29 +1,85 @@
 --- !ruby/object:Gem::Specification
 name: rutabaga
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Lukas Oberhuber
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-07 00:00:00.000000000 Z
+date: 2016-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: turnip
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: gherkin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -52,17 +108,24 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- examples/compatibility/compatibility_spec.rb
 - examples/spec_helper.rb
 - examples/test.feature
 - examples/test2.feature
 - examples/test3.feature
 - examples/test_background.feature
+- examples/test_feature_example_group.feature
+- examples/test_feature_example_group_spec.rb
 - examples/test_spec.rb
 - lib/rutabaga.rb
+- lib/rutabaga/example_group/feature.rb
 - lib/rutabaga/feature.rb
+- lib/rutabaga/util.rb
 - lib/rutabaga/version.rb
+- rutabaga-vs-turnip.jpg
 - rutabaga.gemspec
 - spec/feature_spec.rb
+- spec/rutabaga/util_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/simplybusiness/rutabaga
 licenses:
@@ -84,12 +147,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: Calling Turnip feature files from RSpec, which allows encapsulating a feature
   inside a describe block
 test_files:
 - spec/feature_spec.rb
+- spec/rutabaga/util_spec.rb
 - spec/spec_helper.rb
 has_rdoc: