cucumber 1.3.10 → 2.0.0

data/legacy_features/transform.feature

@@ -1,245 +0,0 @@
-Feature: transform
-  In order to maintain modularity within step definitions
-  As a step definition editor
-  I want to register a regex to capture and tranform step definition arguments.
-
-  Background:         
-    Given a standard Cucumber project directory structure
-    And a file named "features/step_definitions/steps.rb" with:
-      """
-      Then /^I should transform ('\d+' to an Integer)$/ do |integer|
-        integer.should be_kind_of(Integer)
-      end
-
-      Then /^I should transform ('\w+' to a Symbol)$/ do |symbol|
-        symbol.should be_kind_of(Symbol)
-      end
-
-      Then /^I should transform ('\d+' to a Float)$/ do |float|
-        float.should be_kind_of(Float)
-      end
-
-      Then /^I should transform ('\w+' to an Array)$/ do |array|
-        array.should be_kind_of(Array)
-      end
-
-      Then /^I should transform ('\w+' to Nil)$/ do |string|
-        string.should be_nil
-      end
-
-      Then /^I should not transform ('\d+') to an Integer$/ do |string|
-        string.should be_kind_of(String)
-      end
-
-      Then /^I should transform ((?:nothing|'\d+') to an optional Integer)$/ do |integer|
-        integer.should be_nil
-      end
-      """
-    And a file named "features/support/env.rb" with:
-      """
-      Transform /^'\d+' to an Integer$/ do |step_arg|
-        /'(\d+)' to an Integer/.match(step_arg).captures[0].to_i
-      end
-
-      Transform /^(?:nothing|'(\d+)') to an optional Integer$/ do |str|
-        str ? str.to_i : nil
-      end
-
-      Transform /^'(\d+)' to a Float$/ do |integer_string|
-        Transform("'#{integer_string}' to an Integer").to_f
-      end
-
-      Transform(/^('\w+') to Nil$/) {|str| nil }
-
-      Transform(/^('\w+') to a Symbol$/) {|str| str.to_sym }
-
-      module MyHelpers
-        def fetch_array
-          @array
-        end
-      end
-
-      World(MyHelpers)
-
-      Before do
-        @array = []
-      end
-
-      Transform(/^('\w+') to an Array$/) {|str| fetch_array }
-      """
-      
-  Scenario: run a specific scenario with a registered transform
-    Given a file named "features/transform_sample.feature" with:
-      """
-      Feature: Step argument transformations
-
-        Scenario: transform with matches
-          Then I should transform '10' to an Integer
-
-        Scenario: transform with matches that capture
-          Then I should transform 'abc' to a Symbol
-
-        Scenario: transform with matches that reuse transforms
-          Then I should transform '10' to a Float
-
-        Scenario: transform with matches that use current world
-          Then I should transform 'abc' to an Array
-
-        Scenario: transform with matches that return nil
-          Then I should transform 'nil' to Nil
-
-        Scenario: transform without matches
-          Then I should not transform '10' to an Integer
-
-        Scenario: transform with optional arguments not given
-          Then I should transform nothing to an optional Integer
-      """
-    When I run cucumber --backtrace -s features
-    Then it should pass with
-      """
-      Feature: Step argument transformations
-    
-        Scenario: transform with matches
-          Then I should transform '10' to an Integer
-
-        Scenario: transform with matches that capture
-          Then I should transform 'abc' to a Symbol
-
-        Scenario: transform with matches that reuse transforms
-          Then I should transform '10' to a Float
-
-        Scenario: transform with matches that use current world
-          Then I should transform 'abc' to an Array
-
-        Scenario: transform with matches that return nil
-          Then I should transform 'nil' to Nil
-
-        Scenario: transform without matches
-          Then I should not transform '10' to an Integer
-
-        Scenario: transform with optional arguments not given
-          Then I should transform nothing to an optional Integer
-
-      7 scenarios (7 passed)
-      7 steps (7 passed)
-    
-      """
-
-  Scenario: run a table scenario with an unrelated registered transform
-    Given a file named "features/transform_sample.feature" with:
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            |      r |            ra |
-            |      m |            ma |
-            |      p |            pa |
-      """
-    And a file named "features/support/table.rb" with:
-      """
-      Transform /^table:number,number_plus_a$/ do |table|
-        :not_what_you_were_expecting
-      end
-
-      Then "I should check the following table:" do |table|
-        table.hashes.each do |hash|
-          hash['letter_plus_a'].should == (hash['letter'] + 'a')
-        end
-      end
-      """
-    When I run cucumber -s features
-    Then it should pass with
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            | r      | ra            |
-            | m      | ma            |
-            | p      | pa            |
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """
-
-  Scenario: run a table scenario with an related registered transform not using table
-    Given a file named "features/transform_sample.feature" with:
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            |      r |            ra |
-            |      m |            ma |
-            |      p |            pa |
-      """
-    And a file named "features/support/table.rb" with:
-      """
-      Transform /^table:letter,letter_plus_a$/ do |table|
-        1
-      end
-
-      Then "I should check the following table:" do |columns|
-        columns.should == 1
-      end
-      """
-    When I run cucumber -s features
-    Then it should pass with
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            | r      | ra            |
-            | m      | ma            |
-            | p      | pa            |
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """
-
-  Scenario: run a table scenario with an related registered transform using table
-    Given a file named "features/transform_sample.feature" with:
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            |      r |            ra |
-            |      m |            ma |
-            |      p |            pa |
-      """
-    And a file named "features/support/table.rb" with:
-      """
-      Transform /^table:letter,letter_plus_a$/ do |table|
-        table.rows.map { |row| row.join(',') }
-      end
-
-      Then "I should check the following table:" do |rows_in_table|
-        rows_in_table.should == ['r,ra','m,ma','p,pa']
-      end
-      """
-    When I run cucumber -b -s features
-    Then it should pass with
-      """
-      Feature: Step argument transformations
-
-        Scenario: A table
-          Then I should check the following table:
-            | letter | letter_plus_a |
-            | r      | ra            |
-            | m      | ma            |
-            | p      | pa            |
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """

data/legacy_features/unicode_table.feature

@@ -1,35 +0,0 @@
-Feature: Unicode in tables
-  In order to please the whole world,
-  unicode characters in tables should be
-  properly aligned
-  
-  Scenario: All sorts of weird stuff
-    Given a standard Cucumber project directory structure
-    And a file named "features/unicode.feature" with:
-      """
-      Feature: Featuring unicode
-
-        Scenario: So what, whatever
-          Given passing
-            | Brüno | abc |
-            | Bruno | æøå |
-      """
-    And a file named "features/env.rb" with:
-      """
-      $KCODE='u'
-      """
-    When I run cucumber -q --dry-run features/unicode.feature
-    Then it should pass with
-      """
-      Feature: Featuring unicode
-
-        Scenario: So what, whatever
-          Given passing
-            | Brüno | abc |
-            | Bruno | æøå |
-
-      1 scenario (1 undefined)
-      1 step (1 undefined)
-
-      """
-    

data/legacy_features/wire_protocol.feature

@@ -1,332 +0,0 @@
-@wire
-Feature: Wire Protocol
-  In order to be allow Cucumber to touch my app in intimate places
-  As a developer on platform which doesn't support Ruby
-  I want a low-level protocol which Cucumber can use to run steps within my app
-
-  #
-  # Cucumber's wire protocol is an implementation of Cucumber's internal
-  # 'programming language' abstraction, and allows step definitions to be
-  # implemented and invoked on any platform.
-  #
-  # Communication is over a TCP socket, which Cucumber connects to when it finds
-  # a definition file with the .wire extension in the step_definitions folder
-  # (or other load path).  Note that these files are rendered with ERB when loaded.
-  #
-  # Cucumber sends the following request messages out over the wire:
-  #
-  #   * step_matches   : this is used to find out whether the wire server has a
-  #                      definition for a given step
-  #   * invoke         : this is used to ask for a step definition to be invoked
-  #   * begin_scenario : signals that cucumber is about to execute a scenario
-  #   * end_scenario   : signals that cucumber has finished executing a scenario
-  #   * snippet_text   : requests a snippet for an undefined step
-  #
-  # Every message supports two standard responses:
-  #   * success        : which expects different arguments (sometimes none at
-  #                      all) depending on the request.
-  #   * fail           : causes a Cucumber::WireSupport::WireException to be
-  #                      raised.
-  #
-  # Some messages support more responses - see below for details.
-  #
-  # A WirePacket flowing in either direction is formatted as a JSON-encoded
-  # string, with a newline character signaling the end of a packet. See the
-  # specs for Cucumber::WireSupport::WirePacket for more details.
-  #
-  # These messages are described in detail below, with examples.
-  #
-
-  Background:
-    Given a standard Cucumber project directory structure
-    And a file named "features/wired.feature" with:
-      """
-      Feature: High strung
-        Scenario: Wired
-          Given we're all wired
-
-      """
-    And a file named "features/step_definitions/some_remote_place.wire" with:
-      """
-      host: localhost
-      port: 54321
-
-      """
-
-
-  #
-  # # Request: 'step_matches'
-  #
-  # When the features have been parsed, Cucumber will send a step_matches
-  # message to ask the wire server if it can match a step name. This happens for
-  # each of the steps in each of the features.
-  #
-  # The wire server replies with an array of StepMatch objects.
-
-  Scenario: Dry run finds no step match
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response       |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[]] |
-    When I run cucumber --dry-run --no-snippets -f progress
-    And it should pass with
-      """
-      U
-
-      1 scenario (1 undefined)
-      1 step (1 undefined)
-
-      """
-
-  # When each StepMatch is returned, it contains the following data:
-  #   * id   - identifier for the step definition to be used later when if it
-  #            needs to be invoked. The identifier can be any string value and
-  #            is simply used for the wire server's own reference.
-  #   * args - any argument values as captured by the wire end's own regular
-  #            expression (or other argument matching) process.
-  Scenario: Dry run finds a step match
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                            |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[]}]] |
-    When I run cucumber --dry-run -f progress
-    And it should pass with
-      """
-      -
-
-      1 scenario (1 skipped)
-      1 step (1 skipped)
-
-      """
-
-  # Optionally, the StepMatch can also contain a source reference, and a native
-  # regexp string which will be used by some formatters.
-  Scenario: Step matches returns details about the remote step definition
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                                                                           |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[], "source":"MyApp.MyClass:123", "regexp":"we.*"}]] |
-    When I run cucumber -f stepdefs --dry-run
-    Then STDERR should be empty
-    And it should pass with
-      """
-      -
-
-      we.*   # MyApp.MyClass:123
-
-      1 scenario (1 skipped)
-      1 step (1 skipped)
-
-      """
-
-
-  #
-  # # Request: 'invoke'
-  #
-  # Assuming a StepMatch was returned for a given step name, when it's time to
-  # invoke that step definition, Cucumber will send an invoke message.
-  #
-  # The invoke message contains the ID of the step definition, as returned by
-  # the wire server in response to the the step_matches call, along with the
-  # arguments that were parsed from the step name during the same step_matches
-  # call.
-  #
-  # The wire server will normally[1] reply one of the following:
-  #   * success
-  #   * fail
-  #   * pending : optionally takes a message argument
-  #
-  # [1] This isn't the whole story: see also wire_protocol_table_diffing.feature
-  #
-
-  # ## Pending Steps
-  #
-  Scenario: Invoke a step definition which is pending
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                            |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[]}]] |
-      | ["begin_scenario"]                                   | ["success"]                         |
-      | ["invoke",{"id":"1","args":[]}]                      | ["pending", "I'll do it later"]     |
-      | ["end_scenario"]                                     | ["success"]                         |
-    When I run cucumber -f pretty -q
-    And it should pass with
-      """
-      Feature: High strung
-
-        Scenario: Wired
-          Given we're all wired
-            I'll do it later (Cucumber::Pending)
-            features/wired.feature:3:in `Given we're all wired'
-
-      1 scenario (1 pending)
-      1 step (1 pending)
-
-      """
-
-  # ## Passing Steps
-  #
-  Scenario: Invoke a step definition which passes
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                            |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[]}]] |
-      | ["begin_scenario"]                                   | ["success"]                         |
-      | ["invoke",{"id":"1","args":[]}]                      | ["success"]                         |
-      | ["end_scenario"]                                     | ["success"]                         |
-    When I run cucumber -f progress
-    And it should pass with
-      """
-      .
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """
-
-  # ## Failing Steps
-  #
-  # When an invoked step definition fails, it can return details of the exception
-  # in the reply to invoke. This causes a Cucumber::WireSupport::WireException to be
-  # raised.
-  #
-  # Valid arguments are:
-  #   * message (mandatory)
-  #   * exception
-  #   * backtrace
-  #
-  # See the specs for Cucumber::WireSupport::WireException for more details
-  #
-  Scenario: Invoke a step definition which fails
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                                                                            |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[]}]]                                                 |
-      | ["begin_scenario"]                                   | ["success"]                                                                         |
-      | ["invoke",{"id":"1","args":[]}]                      | ["fail",{"message":"The wires are down", "exception":"Some.Foreign.ExceptionType"}] |
-      | ["end_scenario"]                                     | ["success"]                                                                         |
-    When I run cucumber -f progress
-    Then STDERR should be empty
-    And it should fail with
-      """
-      F
-
-      (::) failed steps (::)
-
-      The wires are down (Some.Foreign.ExceptionType from localhost:54321)
-      features/wired.feature:3:in `Given we're all wired'
-
-      Failing Scenarios:
-      cucumber features/wired.feature:2 # Scenario: Wired
-
-      1 scenario (1 failed)
-      1 step (1 failed)
-
-      """
-
-  # ## Step Arguments
-  #
-  # Imagine we have a step definition like:
-  #
-  #     Given /we're all (.*)/ do | what_we_are |
-  #     end
-  #
-  # When this step definition matches the step name in our feature, the word
-  # 'wired' will be captured as an argument.
-  #
-  # Cucumber expects this StepArgument to be returned in the StepMatch. The keys
-  # have the following meanings:
-  #   * val : the value of the string captured for that argument from the step
-  #           name passed in step_matches
-  #   * pos : the position within the step name that the argument was matched
-  #           (used for formatter highlighting)
-  #
-  Scenario: Invoke a step definition which takes string arguments (and passes)
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                              | response                                                     |
-      | ["step_matches",{"name_to_match":"we're all wired"}] | ["success",[{"id":"1", "args":[{"val":"wired", "pos":10}]}]] |
-      | ["begin_scenario"]                                   | ["success"]                                                  |
-      | ["invoke",{"id":"1","args":["wired"]}]               | ["success"]                                                  |
-      | ["end_scenario"]                                     | ["success"]                                                  |
-    When I run cucumber -f progress
-    Then STDERR should be empty
-    And it should pass with
-      """
-      .
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """
-
-  # ## Multiline Table Arguments
-  #
-  # When the step has a multiline table argument, it will be passed with the
-  # invoke message as a string - a serialized JSON array of array of strings.
-  # In the following scenario our step definition takes two arguments - one
-  # captures the "we're" and the other takes the table.
-  Scenario: Invoke a step definition which takes table arguments (and passes)
-    Given a file named "features/wired_on_tables.feature" with:
-      """
-      Feature: High strung
-        Scenario: Wired and more
-          Given we're all:
-            | wired |
-            | high  |
-            | happy |
-      """
-    And there is a wire server running on port 54321 which understands the following protocol:
-      | request                                                               | response                                                    |
-      | ["step_matches",{"name_to_match":"we're all:"}]                       | ["success",[{"id":"1", "args":[{"val":"we're", "pos":0}]}]] |
-      | ["begin_scenario"]                                                    | ["success"]                                                 |
-      | ["invoke",{"id":"1","args":["we're",[["wired"],["high"],["happy"]]]}] | ["success"]                                                 |
-      | ["end_scenario"]                                                      | ["success"]                                                 |
-    When I run cucumber -f progress features/wired_on_tables.feature
-    Then STDERR should be empty
-    And it should pass with
-      """
-      .
-
-      1 scenario (1 passed)
-      1 step (1 passed)
-
-      """
-
-
-  #
-  # # Request: 'snippets'
-  #
-  Scenario: Wire server returns snippets for a step that didn't match
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request                                                                                          | response                         |
-      | ["step_matches",{"name_to_match":"we're all wired"}]                                             | ["success",[]]                   |
-      | ["snippet_text",{"step_keyword":"Given","multiline_arg_class":"","step_name":"we're all wired"}] | ["success","foo()\n  bar;\nbaz"] |
-      | ["begin_scenario"]                                                                               | ["success"]                      |
-      | ["end_scenario"]                                                                                 | ["success"]                      |
-    When I run cucumber -f pretty
-    Then STDERR should be empty
-    And it should pass with
-      """
-      Feature: High strung
-
-        Scenario: Wired         # features/wired.feature:2
-          Given we're all wired # features/wired.feature:3
-
-      1 scenario (1 undefined)
-      1 step (1 undefined)
-
-      You can implement step definitions for undefined steps with these snippets:
-
-      foo()
-        bar;
-      baz
-
-
-      """
-
-  #
-  # # Bad Response
-  #
-  Scenario: Unexpected response
-    Given there is a wire server running on port 54321 which understands the following protocol:
-      | request            | response  |
-      | ["begin_scenario"] | ["yikes"] |
-    When I run cucumber -f progress
-    Then STDERR should match
-      """
-      undefined method `handle_yikes'
-      """

data/lib/README.rdoc

@@ -1,12 +0,0 @@
-= Cucumber API
-
-This is the public API of Cucumber. The public API includes the classes, modules
-and methods you can use if you are a user of Cucumber. It also applies to you if
-you're developing a 3rd party tool that integrates with Cucumber.
-
-== Internal API
-
-Cucumber has more classes, modules and methods than what you can see in the public
-API. If you decide to dive into the source code and make use of an API that isn't
-part of this documentation - beware that this API might change at any time. If you
-want a particular internal API to be promoted to the public API - let us know.