cucumber-core 0.1.0

data/spec/cucumber/core/gherkin/parser_spec.rb

@@ -0,0 +1,182 @@
+# -*- encoding: utf-8 -*-
+require 'cucumber/initializer'
+require 'cucumber/core/gherkin/parser'
+require 'cucumber/core/gherkin/writer'
+
+module Cucumber
+  module Core
+    module Gherkin
+      describe Parser do
+        let(:receiver) { double }
+        let(:parser)   { Parser.new(receiver) }
+        let(:visitor)  { double }
+
+        def parse
+          parser.document(source)
+        end
+
+        context "for invalid gherkin" do
+          let(:source) { Gherkin::Document.new(path, 'not gherkin') }
+          let(:path)   { 'path_to/the.feature' }
+
+          it "raises an error" do
+            expect { parse }.to raise_error(ParseError) do |error|
+              expect( error.message ).to match(/not gherkin/)
+              expect( error.message ).to match(/#{path}/)
+            end
+          end
+        end
+
+        include Writer
+        def self.source(&block)
+          let(:source) { gherkin(&block) }
+        end
+
+        def feature
+          result = nil
+          receiver.stub(:feature) { |feature| result = feature }
+          parse
+          result
+        end
+
+        context "when the Gherkin has a language header" do
+          source do
+            feature(language: 'ja', keyword: '機能')
+          end
+
+          it "sets the language from the Gherkin" do
+            feature.language.iso_code.should == 'ja'
+          end
+        end
+
+        context "a Scenario with a DocString" do
+          source do
+            feature do
+              scenario do
+                step do
+                  doc_string("content")
+                end
+              end
+            end
+          end
+
+          it "parses doc strings without error" do
+            visitor.stub(:feature).and_yield
+            visitor.stub(:scenario).and_yield
+            visitor.stub(:step).and_yield
+
+            location = double
+            expected = Ast::DocString.new("content", "", location)
+            expect( visitor ).to receive(:doc_string).with(expected)
+            feature.describe_to(visitor)
+          end
+
+        end
+
+        context "a Scenario with a DataTable" do
+          source do
+            feature do
+              scenario do
+                step do
+                  table do
+                    row "name", "surname"
+                    row "rob",  "westgeest"
+                  end
+                end
+              end
+            end
+          end
+
+          it "parses the DataTable" do
+            visitor = double
+            visitor.stub(:feature).and_yield
+            visitor.stub(:scenario).and_yield
+            visitor.stub(:step).and_yield
+
+            expected = Ast::DataTable.new([['name', 'surname'], ['rob', 'westgeest']], Ast::Location.new('foo.feature', 23))
+            expect( visitor ).to receive(:table).with(expected)
+            feature.describe_to(visitor)
+          end
+        end
+
+        context "a Scenario with a Comment" do
+          source do
+            feature do
+              comment 'wow'
+              scenario
+            end
+          end
+
+          it "parses the comment into the AST" do
+            visitor = double
+            visitor.stub(:feature).and_yield
+            expect( visitor ).to receive(:scenario) do |scenario|
+              expect( scenario.comments.join ).to eq "# wow"
+            end
+            feature.describe_to(visitor)
+          end
+        end
+
+        context "a Scenario Outline" do
+          source do
+            feature do
+              scenario_outline 'outline name' do
+                step 'passing <arg>'
+
+                examples do
+                  row 'arg'
+                  row '1'
+                  row '2'
+                end
+
+                examples do
+                  row 'arg'
+                  row 'a'
+                end
+              end
+            end
+          end
+
+          it "creates a scenario outline node" do
+            visitor.stub(:feature).and_yield
+            expect( visitor ).to receive(:scenario_outline) do |outline|
+              expect( outline.name ).to eq 'outline name'
+            end
+            feature.describe_to(visitor)
+          end
+
+          it "creates a step node for each step of the scenario outline" do
+            visitor.stub(:feature).and_yield
+            visitor.stub(:scenario_outline).and_yield
+            visitor.stub(:examples_table)
+            expect( visitor ).to receive(:outline_step) do |step|
+              expect( step.name ).to eq 'passing <arg>'
+            end
+            feature.describe_to(visitor)
+          end
+
+          it "creates an examples table node for each examples table" do
+            visitor.stub(:feature).and_yield
+            visitor.stub(:scenario_outline).and_yield
+            visitor.stub(:outline_step)
+            expect( visitor ).to receive(:examples_table).exactly(2).times.and_yield
+            expect( visitor ).to receive(:examples_table_row) do |row|
+              expect( row.number ).to eq 1
+              expect( row.values ).to eq ['1']
+            end.once.ordered
+            expect( visitor ).to receive(:examples_table_row) do |row|
+              expect( row.number ).to eq 2
+              expect( row.values ).to eq ['2']
+            end.once.ordered
+            expect( visitor ).to receive(:examples_table_row) do |row|
+              expect( row.number ).to eq 1
+              expect( row.values ).to eq ['a']
+            end.once.ordered
+            feature.describe_to(visitor)
+          end
+
+        end
+      end
+    end
+  end
+end

data/spec/cucumber/core/gherkin/writer_spec.rb

@@ -0,0 +1,332 @@
+require 'cucumber/core/gherkin/writer'
+require 'unindent'
+
+module Cucumber::Core::Gherkin
+  describe Writer do
+    include Writer
+
+    context 'specifying uri' do
+      it 'generates a uri by default' do
+        source = gherkin { feature }
+        expect( source.uri ).to eq 'features/test.feature'
+      end
+
+      it 'allows you to specify a URI' do
+        source = gherkin('features/path/to/my.feature') { feature }
+        expect( source.uri ).to eq 'features/path/to/my.feature'
+      end
+    end
+
+    context 'a feature' do
+
+      it 'generates the feature statement' do
+        source = gherkin { feature }
+        expect( source ).to eq "Feature:\n"
+      end
+
+      context 'when a name is provided' do
+        it 'includes the name in the feature statement' do
+          source = gherkin do
+            feature "A Feature\n"
+          end
+          expect( source ).to eq "Feature: A Feature\n"
+        end
+      end
+
+      context 'when a description is provided' do
+        it 'includes the description in the feature statement' do
+          source = gherkin do
+            feature "A Feature", description: <<-END
+              This is the description
+              which can span
+              multiple lines.
+              END
+          end
+          expected = <<-END
+          Feature: A Feature
+            This is the description
+            which can span
+            multiple lines.
+          END
+
+          expect( source ).to eq expected.unindent
+        end
+      end
+
+      context 'when a keyword is provided' do
+        it 'uses the supplied keyword' do
+          source = gherkin do
+            feature "A Feature", keyword: "Business Need"
+          end
+          expect( source ).to eq "Business Need: A Feature\n"
+        end
+      end
+
+      context 'when a language is supplied' do
+        it 'inserts a language statement' do
+          source = gherkin do
+            feature language: 'ru'
+          end
+
+          expect( source ).to eq "# language: ru\nFeature:\n"
+        end
+      end
+
+      context 'when a comment is supplied' do
+        it 'inserts a comment' do
+          source = gherkin do
+            comment 'wow'
+            comment 'great'
+            feature
+          end
+
+          expect( source.to_s ).to eq "# wow\n# great\nFeature:\n"
+        end
+      end
+
+      context 'with a scenario' do
+        it 'includes the scenario statement' do
+          source = gherkin do
+            feature "A Feature" do
+              scenario
+            end
+          end
+
+          expect( source.to_s ).to match(/Scenario:/)
+        end
+
+        context 'when a comment is provided' do
+          it 'includes the comment in the scenario statement' do
+            source = gherkin do
+              feature do
+                comment 'wow'
+                scenario
+              end
+            end
+            expect( source.to_s ).to eq <<-END.unindent
+            Feature:
+
+              # wow
+              Scenario:
+            END
+          end
+        end
+
+        context 'when a description is provided' do
+          it 'includes the description in the scenario statement' do
+            source = gherkin do
+              feature do
+                scenario description: <<-END
+                  This is the description
+                  which can span
+                  multiple lines.
+                  END
+              end
+            end
+
+            expect( source ).to eq <<-END.unindent
+            Feature:
+
+              Scenario:
+                This is the description
+                which can span
+                multiple lines.
+            END
+          end
+        end
+
+        context 'with a step' do
+          it 'includes the step statement' do
+            source = gherkin do
+              feature "A Feature" do
+                scenario do
+                  step 'passing'
+                end
+              end
+            end
+
+            expect( source.to_s ).to match(/Given passing\Z/m)
+          end
+
+          context 'when a docstring is provided' do
+            it 'includes the content type when provided' do
+              source = gherkin do
+                feature do
+                  scenario do
+                    step 'failing' do
+                      doc_string 'some text', 'text/plain'
+                    end
+                  end
+                end
+
+              end
+
+              expect( source ).to eq <<-END.unindent
+              Feature:
+
+                Scenario:
+                  Given failing
+                    """text/plain
+                    some text
+                    """
+              END
+            end
+          end
+        end
+      end
+
+      context 'with a background' do
+        it 'can have a description' do
+          source = gherkin do
+            feature do
+              background description: "One line,\nand two.."
+            end
+          end
+
+          expect( source ).to eq <<-END.unindent
+          Feature:
+
+            Background:
+              One line,
+              and two..
+          END
+        end
+      end
+
+      context 'with a scenario outline' do
+        it 'can have a description' do
+          source = gherkin do
+            feature do
+              scenario_outline description: "Doesn't need to be multi-line."
+            end
+          end
+
+          expect( source ).to eq <<-END.unindent
+          Feature:
+
+            Scenario Outline:
+              Doesn't need to be multi-line.
+          END
+        end
+
+        context 'and examples table' do
+          it 'can have a description' do
+            source = gherkin do
+              feature do
+                scenario_outline do
+                  examples description: "Doesn't need to be multi-line." do
+
+                  end
+                end
+              end
+            end
+
+            expect( source ).to eq <<-END.unindent
+            Feature:
+
+              Scenario Outline:
+
+                Examples:
+                  Doesn't need to be multi-line.
+            END
+          end
+        end
+      end
+    end
+
+    it 'generates a complex feature' do
+      source = gherkin do
+        comment 'wow'
+        feature 'Fully featured', language: 'en', tags: '@always' do
+          comment 'cool'
+          background do
+            step 'passing'
+          end
+
+          scenario do
+            step 'passing'
+          end
+
+          comment 'here'
+          scenario 'with doc string', tags: '@first @second' do
+            comment 'and here'
+            step 'passing'
+            step 'failing', keyword: 'When' do
+              doc_string <<-END
+              I wish I was a little bit taller.
+              I wish I was a baller.
+              END
+            end
+          end
+
+          scenario 'with a table...' do
+            step 'passes:' do
+              table do
+                row 'name',   'age', 'location'
+                row 'Janine', '43',  'Antarctica'
+              end
+            end
+          end
+
+          comment 'yay'
+          scenario_outline 'eating' do
+            step 'there are <start> cucumbers'
+            step 'I eat <eat> cucumbers', keyword: 'When'
+            step 'I should have <left> cucumbers', keyword: 'Then'
+
+            comment 'hmmm'
+            examples do
+              row 'start', 'eat', 'left'
+              row '12',    '5',   '7'
+              row '20',    '5',   '15'
+            end
+          end
+        end
+      end
+
+      expect( source.to_s ).to eq <<-END.unindent
+      # language: en
+      # wow
+      @always
+      Feature: Fully featured
+
+        # cool
+        Background:
+          Given passing
+
+        Scenario:
+          Given passing
+
+        # here
+        @first @second
+        Scenario: with doc string
+          # and here
+          Given passing
+          When failing
+            """
+            I wish I was a little bit taller.
+            I wish I was a baller.
+            """
+
+        Scenario: with a table...
+          Given passes:
+            | name   | age | location   |
+            | Janine | 43  | Antarctica |
+
+        # yay
+        Scenario Outline: eating
+          Given there are <start> cucumbers
+          When I eat <eat> cucumbers
+          Then I should have <left> cucumbers
+
+          # hmmm
+          Examples:
+            | start | eat | left |
+            | 12    | 5   | 7    |
+            | 20    | 5   | 15   |
+      END
+
+    end
+  end
+end
+