turnip 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 244b05edd98a840b930b2ead6b49bb2054cc84e8
-  data.tar.gz: c116ea751e8f8c443e24d731b25f2d8f0faf70d4
+  metadata.gz: bdb367c9acc76b2fb0f4abbbedf8730ce97f3d33
+  data.tar.gz: 69314b7771dfcd5a645b4a41b01d1c99c84ae5e6
 SHA512:
-  metadata.gz: a55c0893be54b1858157e288965ae6e33e50296c5ff53e817a68330f3c53162631f05aa69fba8b3889339997115ae15044c7e6c433ee1c3b6cb0b4141fbc9a61
-  data.tar.gz: 6e438b7cc2c80cc96437ef557b72cf0bab46ce829ffd5e209ae9bbced49d872146b8c739d612b5db07e2a20bc7a404ad9913427314ed42f61ff5eeab23ae4de8
+  metadata.gz: 0ba3f6f9153835411c293efb95224f4e3a0a22e6f896a2df4ab52739c9ae66a661658c10e214a7a06bb6bb625c16c8bb4105739c93d0abcf8b2d3b63ea190e8b
+  data.tar.gz: 2305ebaeee98b1da8a8f599fc3a94c51c27487732e9af2d5762f56260cebf186665a38e1123249860f6330f8ca7865276d974d00c116bf33455c6be2ac20ce8b

data/README.md

@@ -1,18 +1,13 @@
 # Turnip
 
 [![Build Status](https://secure.travis-ci.org/jnicklas/turnip.png)](http://travis-ci.org/jnicklas/turnip)
-[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/jnicklas/turnip)
+[![Code Climate](https://codeclimate.com/github/jnicklas/turnip.png)](https://codeclimate.com/github/jnicklas/turnip)
 
 Turnip is a [Gherkin](https://github.com/cucumber/cucumber/wiki/Gherkin)
 extension for RSpec. It allows you to write tests in Gherkin and run them
 through your RSpec environment. Basically you can write cucumber features in
 RSpec.
 
-## Maintainer wanted!
-
-Are you interested in maintaining Turnip's code base? Please get in touch with
-[me](http://github.com/jnicklas). 
-
 ## Installation
 
 Install the gem
@@ -98,6 +93,30 @@ RSpec.configure { |c| c.include MonsterSteps }
 Steps are implemented as regular Ruby methods under the hood, so you can
 use Ruby's normal inheritance chain to mix and match steps.
 
+### Before/After Hooks
+
+Since Turnip runs atop RSpec, it can utilize RSpec's built-in before and after
+hooks. To run a hook for all features, specify a global hook with `type` set
+to `:feature`:
+
+```ruby
+config.before(:type => :feature) do
+  do_something
+end
+config.after(:type => :feature) do
+  do_something_else
+end
+```
+
+You can also limit this to a tag by specifying the tag in the argument to
+`before` or `after`:
+
+```ruby
+config.before(:some_tag => true) do
+  do_something
+end
+```
+
 ### Global steps
 
 Turnip has a special module called `Turnip::Steps`, which is automatically
@@ -217,6 +236,14 @@ Before loading your `spec_helper`, Turnip also tries to load a file called
 You might find it beneficial to load your steps from this file so that they
 don't have to be loaded when you run your other tests.
 
+If you use Turnip with [rspec-rails](https://github.com/rspec/rspec-rails) v3.x, most configuration written to `rails_helper.rb` but not `spec_helper.rb`. So you should write to `turnip_helper` like this:
+
+```ruby
+require 'rails_helper'
+```
+
+Then you can write configuration to `rails_helper` to load your steps.
+
 ### Calling steps from other steps
 
 Since steps are Ruby methods you can call them like other Ruby methods.
@@ -333,6 +360,26 @@ step "there are the following monsters:" do |table|
 end
 ```
 
+## Substitution in Scenario Outlines
+
+You would be able to use substitution that can be used to DocString and Table arguments in Scenario Outline like [Cucumber](http://cukes.info/step-definitions.html#substitution_in_scenario_outlines):
+
+```cucumber
+Scenario Outline: Email confirmation
+  Given I have a user account with my name "Jojo Binks"
+  When an Admin grants me <Role> rights
+  Then I should receive an email with the body:
+    """
+    Dear Jojo Binks,
+    You have been granted <Role> rights.  You are <details>. Please be responsible.
+    -The Admins
+    """
+  Examples:
+    |  Role     | details                                         |
+    |  Manager  | now able to manage your employee accounts       |
+    |  Admin    | able to manage any user account on the system   |
+```
+
 ## Using with Capybara
 
 Just require `turnip/capybara` in your `spec_helper`. You can now use the same

data/examples/scenario_outline_multiline_string_substitution.feature

@@ -0,0 +1,13 @@
+Feature: using scenario outlines
+  Scenario Outline: a simple outline
+    Given there is a monster called <name>
+    Then the monster introduced himself:
+      """
+      Ahhhhhhh! i'm <name>!
+      """
+
+    Examples:
+      | name          |
+      | John          |
+      | "John Smith"  |
+      | "O'Flannahan" |

data/examples/steps/steps.rb

@@ -44,6 +44,10 @@ step "it should be nameless" do
   @monster_name.should == ""
 end
 
+step "the monster introduced himself:" do |self_introduction|
+  self_introduction.should include @monster_name
+end
+
 step "there is a monster with :count hitpoints" do |count|
   @monster = count
 end

data/lib/turnip/builder.rb

@@ -87,10 +87,16 @@ module Turnip
             scenario.steps = steps.map do |step|
               new_description = substitute(step.description, headers, row)
               new_extra_args = step.extra_args.map do |ea|
-                next ea unless ea.instance_of?(Turnip::Table)
-                Turnip::Table.new(ea.map {|t_row| t_row.map {|t_col| substitute(t_col, headers, row) } })
+                case ea
+                when String
+                  substitute(ea, headers, row)
+                when Turnip::Table
+                  Turnip::Table.new(ea.map {|t_row| t_row.map {|t_col| substitute(t_col, headers, row) } })
+                else
+                  ea
+                end
               end
-              Step.new(new_description, new_extra_args, step.line)
+              Step.new(new_description, new_extra_args, step.line, step.keyword)
             end
           end
         end
@@ -103,7 +109,7 @@ module Turnip
       end
     end
 
-    class Step < Struct.new(:description, :extra_args, :line)
+    class Step < Struct.new(:description, :extra_args, :line, :keyword)
       # 1.9.2 support hack
       def split(*args)
         self.to_s.split(*args)
@@ -160,7 +166,7 @@ module Turnip
         table = Turnip::Table.new(step.rows.map(&:cells).map(&:to_a))
         extra_args.push(table)
       end
-      @current_step_context.steps << Step.new(step.name, extra_args, step.line)
+      @current_step_context.steps << Step.new(step.name, extra_args, step.line, step.keyword)
     end
 
     def uri(*)

data/lib/turnip/capybara.rb

@@ -2,9 +2,12 @@ require 'capybara/rspec'
 
 RSpec.configure do |config|
   config.before do
-    if self.class.include?(Capybara::DSL) and example.metadata[:turnip]
-      Capybara.current_driver = Capybara.javascript_driver if example.metadata.has_key?(:javascript)
-      example.metadata.each do |tag, value|
+    current_example = example if respond_to?(:example)
+    current_example ||= RSpec.current_example
+
+    if self.class.include?(Capybara::DSL) and current_example.metadata[:turnip]
+      Capybara.current_driver = Capybara.javascript_driver if current_example.metadata.has_key?(:javascript)
+      current_example.metadata.each do |tag, value|
         if Capybara.drivers.has_key?(tag)
           Capybara.current_driver = tag
         end

data/lib/turnip/placeholder.rb

@@ -27,7 +27,7 @@ module Turnip
 
       def default
         @default ||= new(:default) do
-          match %r((?:"([^"]*)"|'([^']*)'|([a-zA-Z0-9_-]+))) do |first, second, third|
+          match %r((?:"([^"]*)"|'([^']*)'|([[:alnum:]_-]+))) do |first, second, third|
             first or second or third
           end
         end

data/lib/turnip/rspec.rb

@@ -46,7 +46,13 @@ module Turnip
           # This is kind of a hack, but it will make RSpec throw way nicer exceptions
           example = Turnip::RSpec.fetch_current_example(self)
           example.metadata[:line_number] = step.line
-          pending("No such step: '#{e}'")
+          example.metadata[:location] = "#{example.metadata[:file_path]}:#{step.line}"
+
+          if ::RSpec::Version::STRING >= '2.99.0'
+            skip("No such step: '#{e}'")
+          else
+            pending("No such step: '#{e}'")
+          end
         rescue StandardError => e
           e.backtrace.push "#{feature_file}:#{step.line}:in `#{step.description}'"
           raise e
@@ -65,7 +71,7 @@ module Turnip
 
       def run(feature_file)
         Turnip::Builder.build(feature_file).features.each do |feature|
-          describe feature.name, feature.metadata_hash do
+          ::RSpec.describe feature.name, feature.metadata_hash do
             before do
               example = Turnip::RSpec.fetch_current_example(self)
               # This is kind of a hack, but it will make RSpec throw way nicer exceptions

data/lib/turnip/step_definition.rb

@@ -38,7 +38,7 @@ module Turnip
 
     OPTIONAL_WORD_REGEXP = /(\\\s)?\\\(([^)]+)\\\)(\\\s)?/
     PLACEHOLDER_REGEXP = /:([\w]+)/
-    ALTERNATIVE_WORD_REGEXP = /(\w+)((\/\w+)+)/
+    ALTERNATIVE_WORD_REGEXP = /([[:alpha:]]+)((\/[[:alpha:]]+)+)/
 
     def compile_regexp
       @placeholder_names = []

data/lib/turnip/version.rb

@@ -1,3 +1,3 @@
 module Turnip
-  VERSION = "1.2.1"
+  VERSION = "1.2.2"
 end

data/spec/builder_spec.rb

@@ -1,11 +1,32 @@
 require 'spec_helper'
 
 describe Turnip::Builder do
+  let(:builder) { Turnip::Builder.build(feature_file) }
+  let(:feature) { builder.features.first }
+
+  context 'simple scenarios' do
+    let(:feature_file) { File.expand_path('../examples/simple_feature.feature', File.dirname(__FILE__)) }
+    let(:steps) { feature.scenarios.first.steps }
+
+    it 'extracts step description' do
+      steps.map(&:description).should eq([
+        'there is a monster',
+        'I attack it',
+        'it should die'
+      ])
+    end
+
+    it 'extracts step line' do
+      steps.map(&:line).should eq([3, 4, 5])
+    end
+
+    it 'extracts step keyword' do
+      steps.map(&:keyword).should eq(['Given ', 'When ', 'Then '])
+    end
+  end
+
   context "with scenario outlines" do
     let(:feature_file) { File.expand_path('../examples/scenario_outline.feature', File.dirname(__FILE__)) }
-    let(:builder) { Turnip::Builder.build(feature_file) }
-    let(:feature) { builder.features.first }
-
 
     it "extracts scenarios" do
       feature.scenarios.map(&:name).should eq([
@@ -30,8 +51,6 @@ describe Turnip::Builder do
 
   context "with example tables in scenario outlines" do
     let(:feature_file) { File.expand_path('../examples/scenario_outline_table_substitution.feature', File.dirname(__FILE__)) }
-    let(:builder) { Turnip::Builder.build(feature_file) }
-    let(:feature) { builder.features.first }
 
     it "replaces placeholders in tables in steps" do
       feature.scenarios[0].steps.map(&:description).should eq([
@@ -44,6 +63,20 @@ describe Turnip::Builder do
       table = feature.scenarios[1].steps[0].extra_args.find {|a| a.instance_of?(Turnip::Table)}
       table.hashes[0]['hit_points'].should == '8'
     end
+  end
 
+  context 'with example multiline in scenario outlines' do
+    let(:feature_file) { File.expand_path('../examples/scenario_outline_multiline_string_substitution.feature', File.dirname(__FILE__)) }
+    let(:steps) { feature.scenarios[1].steps }
+
+    it 'replaces placeholders in multiline in steps' do
+      steps.map(&:description).should eq([
+        'there is a monster called "John Smith"',
+        'the monster introduced himself:'
+      ])
+
+      multiline = steps[1].extra_args.first
+      multiline.should eq %q(Ahhhhhhh! i'm "John Smith"!)
+    end
   end
 end

data/spec/integration_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 
 describe 'The CLI', :type => :integration do
   before do
-    @result = %x(rspec -fs examples/*.feature)
+    @result = %x(rspec -fd examples/*.feature)
   end
 
   it "shows the correct description" do
@@ -11,7 +11,7 @@ describe 'The CLI', :type => :integration do
   end
 
   it "prints out failures and successes" do
-    @result.should include('35 examples, 3 failures, 5 pending')
+    @result.should include('38 examples, 3 failures, 5 pending')
   end
 
   it "includes features in backtraces" do
@@ -30,7 +30,7 @@ describe 'The CLI', :type => :integration do
   it 'conforms to line-number option' do
     @result.should include('rspec ./examples/errors.feature:4')
     @result.should include('rspec ./examples/errors.feature:6')
-    result_with_line_number = %x(rspec -fs ./examples/errors.feature:4)
+    result_with_line_number = %x(rspec -fd ./examples/errors.feature:4)
     result_with_line_number.should include('rspec ./examples/errors.feature:4')
     result_with_line_number.should_not include('rspec ./examples/errors.feature:6')
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turnip
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - Jonas Nicklas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-12 00:00:00.000000000 Z
+date: 2014-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -94,6 +94,7 @@ files:
 - examples/multiline_string.feature
 - examples/pending.feature
 - examples/scenario_outline.feature
+- examples/scenario_outline_multiline_string_substitution.feature
 - examples/scenario_outline_table_substitution.feature
 - examples/simple_feature.feature
 - examples/step_calling.feature
@@ -151,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: turnip
-rubygems_version: 2.2.1
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Gherkin extension for RSpec
@@ -164,4 +165,3 @@ test_files:
 - spec/spec_helper.rb
 - spec/step_definition_spec.rb
 - spec/table_spec.rb
-has_rdoc: