lucid-tdl 1.0.0

data/test/lucid-tdl/parser/full_parsing_test.rb

@@ -0,0 +1,74 @@
+require 'test_helper'
+
+module LucidTDL
+  describe 'Full Test Specification Parsing' do
+    before do
+      @scenario = """Feature: Ability to use Lucid TDL
+        As a test specification writer
+        I need a test description language
+        so that I can structure tests
+        
+        Background:
+          Given a generic context
+          And one that happens for all scenarios
+          
+        Scenario: A basic test
+          When an action takes place
+          Then an observable occurs
+          
+        @selenium @wip
+        Scenario: Another basic test
+          When another action takes place
+          Then another observable occurs
+      """
+      
+      parser = LucidTDL::Parser.new
+      @result = parser.parse(@scenario)
+    end
+    
+    it "generates a tree hierarchy" do
+      @result.must_be_kind_of AST::Feature
+      @result.line.must_equal 1
+      
+      @result.description.must_equal [
+        "As a test specification writer",
+        "I need a test description language",
+        "so that I can structure tests"]
+      
+      background = @result.background
+      background.must_be_kind_of AST::Background
+      background.line.must_equal 6
+      background.steps.first.keyword.must_equal 'Given'
+      background.steps.first.name.must_equal 'a generic context'
+      background.steps.first.line.must_equal 7
+      background.steps.last.keyword.must_equal 'And'
+      background.steps.last.name.must_equal 'one that happens for all scenarios'
+      background.steps.last.line.must_equal 8
+      
+      first_scenario = @result.scenarios.first
+      first_scenario.must_be_kind_of AST::Scenario
+      first_scenario.line.must_equal 10
+      first_scenario.name.must_equal 'A basic test'
+      first_scenario.steps.first.keyword.must_equal 'When'
+      first_scenario.steps.first.name.must_equal 'an action takes place'
+      first_scenario.steps.first.line.must_equal 11
+      first_scenario.steps.last.keyword.must_equal 'Then'
+      first_scenario.steps.last.name.must_equal 'an observable occurs'
+      first_scenario.steps.last.line.must_equal 12
+      
+      last_scenario = @result.scenarios.last
+      last_scenario.must_be_kind_of AST::Scenario
+      last_scenario.line.must_equal 15
+      last_scenario.name.must_equal 'Another basic test'
+      last_scenario.tags.first.name.must_equal 'selenium'
+      last_scenario.tags.last.name.must_equal 'wip'
+      
+      last_scenario.steps.first.keyword.must_equal 'When'
+      last_scenario.steps.first.name.must_equal 'another action takes place'
+      last_scenario.steps.first.line.must_equal 16
+      last_scenario.steps.last.keyword.must_equal 'Then'
+      last_scenario.steps.last.name.must_equal 'another observable occurs'
+      last_scenario.steps.last.line.must_equal 17
+    end
+  end
+end

data/test/lucid-tdl/parser/lexer_test.rb

@@ -0,0 +1,70 @@
+require 'test_helper'
+
+module LucidTDL
+  describe Parser do
+    before do
+      @lexer = Parser.new
+    end
+    
+    it "can parse a single newline character" do
+      @lexer.tokenize("\n").must_equal [[:NEWLINE, "\n"]]
+    end
+    
+    it "can parse multiple newline characters" do
+      @lexer.tokenize("\n\n").must_equal [[:NEWLINE, "\n"], [:NEWLINE, "\n"]]
+    end
+    
+    it "can parse text strings" do
+      @lexer.tokenize("simple text").must_equal [[:TEXT, "simple text"]]
+    end
+    
+    it "strip parsed text strings" do
+      @lexer.tokenize("  simple text  ").must_equal [[:TEXT, "simple text"]]
+    end
+    
+    it "parses a single tag" do
+      @lexer.tokenize("@selenium @headless").must_equal [
+        [:TAG, "selenium"],
+        [:TAG, "headless"],
+      ]
+    end
+    
+    it "parses multiple tags" do
+      
+    end
+    
+    describe "high-level structural keywords" do
+      %w(Feature: Ability: Responsibility:).each do |keyword|
+        it "parses #{keyword}:" do
+          name = keyword[0..-2]
+          @lexer.tokenize(keyword).must_equal [[name.upcase.to_sym, name]]
+        end
+      end
+    end
+    
+    describe "operational structural keywords" do
+      %w(Background: Scenario: Test:).each do |keyword|
+        it "parses #{keyword}:" do
+          name = keyword[0..-2]
+          @lexer.tokenize(keyword).must_equal [[name.upcase.to_sym, name]]
+        end
+      end
+    end
+    
+    describe "specific step keywords" do
+      %w(Given When Then And But).each do |keyword|
+        it "parses #{keyword}" do
+          @lexer.tokenize(keyword).must_equal [[keyword.upcase.to_sym, keyword]]
+        end
+      end
+    end
+    
+    describe "generic step keywords" do
+      %w(*).each do |keyword|
+        it "parses #{keyword}" do
+          @lexer.tokenize(keyword).must_equal [[:GENERIC, "*"]]
+        end
+      end
+    end
+  end
+end

data/test/lucid-tdl/parser/parser_test.rb

@@ -0,0 +1,179 @@
+require 'test_helper'
+
+module LucidTDL
+  describe Parser do
+    
+    def parse(input)
+      parser = Parser.new
+      parser.parse(input)
+    end
+    
+    describe "Feature Element" do
+      it "parses feature description without narrative" do
+        feature = parse("Feature: Test Feature")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Feature"
+      end
+      
+      it "parses feature description with narrative" do
+        feature = parse("Feature: Test Feature\n  As a... \n  I want... \n  So that...\n")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Feature"
+      end
+      
+      it "parses a feature with tags" do
+        feature = parse("""
+          @wip @selenium
+          Feature: Test Feature
+        """)
+        feature.name.must_equal "Test Feature"
+        feature.tags.first.name.must_equal "wip"
+        feature.tags.last.name.must_equal "selenium"
+      end
+      
+      it "parses a feature with tags, without prior newline" do
+        feature = parse("@wip\nFeature: Test Feature")
+        feature.name.must_equal "Test Feature"
+        feature.tags.first.name.must_equal "wip"
+      end
+    end
+    
+    describe "Ability Element" do
+      it "parses ability description without narrative" do
+        feature = parse("Ability: Test Ability")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Ability"
+      end
+      
+      it "parses ability description with narrative" do
+        feature = parse("Ability: Test Ability\n  As a... \n  I want... \n  So that...\n")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Ability"
+      end
+    end
+    
+    describe "Responsility Element" do
+      it "parses responsibility description without narrative" do
+        feature = parse("Responsibility: Test Responsibility")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Responsibility"
+      end
+      
+      it "parses responsibility description with narrative" do
+        feature = parse("Responsibility: Test Responsibility\n  As a... \n  I want... \n  So that...\n")
+        feature.must_be_kind_of AST::Feature
+        feature.name.must_equal "Test Responsibility"
+      end
+    end
+    
+    describe "Backgrounds and Context" do
+      it "parses a background" do
+        feature = parse("""
+          Feature: Test Feature
+          
+            Background:
+              Given a situation applies
+              And a context is operative
+        """)
+        feature.name.must_equal "Test Feature"
+        feature.background.must_be_kind_of AST::Background
+        steps = feature.background.steps
+        
+        given_step = steps.first
+        and_step = steps.last
+        
+        given_step.keyword.must_equal "Given"
+        given_step.name.must_equal "a situation applies"
+        and_step.keyword.must_equal "And"
+        and_step.name.must_equal "a context is operative"
+      end
+      
+      it "parses a context" do
+        feature = parse("""
+          Feature: Test Feature
+          
+            Context:
+              Given a situation applies
+              And a context is operative
+        """)
+        feature.name.must_equal "Test Feature"
+        feature.background.must_be_kind_of AST::Background
+        steps = feature.background.steps
+        
+        given_step = steps.first
+        and_step = steps.last
+        
+        given_step.keyword.must_equal "Given"
+        given_step.name.must_equal "a situation applies"
+        and_step.keyword.must_equal "And"
+        and_step.name.must_equal "a context is operative"
+      end
+    end
+    
+    describe "Scenarios and Tests" do
+      it "parses a feature with scenarios and tests" do
+        feature = parse("""
+          Feature: Test Feature
+          
+            Scenario: A Scenario
+              Given some context
+              When some action
+              Then some observable
+              
+            Test: A Test
+              Given some context
+              When some action
+              And some other action
+              Then some observable
+              But not some other observable
+        """)
+        scenarios = feature.scenarios
+        
+        first_scenario = scenarios.first
+        last_scenario = scenarios.last
+        
+        first_scenario.name.must_equal "A Scenario"
+        first_scenario.steps.first.name.must_equal "some context"
+        first_scenario.steps.last.name.must_equal "some observable"
+        
+        last_scenario.name.must_equal "A Test"
+        last_scenario.steps.first.name.must_equal "some context"
+        last_scenario.steps.last.name.must_equal "not some other observable"
+      end
+      
+      it "parses a feature with generic steps" do
+        feature = parse("""
+          Feature: Test Feature
+          
+            Scenario: A Scenario
+              * some context
+              * some action
+        """)
+        scenarios = feature.scenarios
+        
+        first_scenario = scenarios.first
+        
+        first_scenario.name.must_equal "A Scenario"
+        first_scenario.steps.first.name.must_equal "some context"
+        first_scenario.steps.last.name.must_equal "some action"
+      end
+      
+      it "parses a scenario with tags" do
+        feature = parse("""
+          Feature: Test Feature
+            
+            @critical @regression @smoke
+            Scenario: A Scenario
+              Given some context
+              When some action
+              Then some observable
+        """)
+        scenarios = feature.scenarios
+        first_scenario  = scenarios.first
+        first_scenario.tags[0].name.must_equal "critical"
+        first_scenario.tags[1].name.must_equal "regression"
+        first_scenario.tags[2].name.must_equal "smoke"
+      end
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+require 'minitest/spec'
+require 'minitest/autorun'
+
+require_relative '../lib/lucid-tdl'

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: lucid-tdl
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jeff Nyman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-12 00:00:00.000000000 Z
+dependencies: []
+description: Test Description Language
+email:
+- jeffnyman@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/lucid-tdl.rb
+- lib/lucid-tdl/ast.rb
+- lib/lucid-tdl/parser/lexer.rb
+- lib/lucid-tdl/parser/lucid-tdl.rex
+- lib/lucid-tdl/parser/lucid-tdl.y
+- lib/lucid-tdl/parser/parser.rb
+- lib/lucid-tdl/version.rb
+- lucid-tdl.gemspec
+- test/lucid-tdl/parser/ast_test.rb
+- test/lucid-tdl/parser/full_parsing_test.rb
+- test/lucid-tdl/parser/lexer_test.rb
+- test/lucid-tdl/parser/parser_test.rb
+- test/test_helper.rb
+homepage: https://github.com/jnyman/lucid-tdl
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Test Description Language
+test_files:
+- test/lucid-tdl/parser/ast_test.rb
+- test/lucid-tdl/parser/full_parsing_test.rb
+- test/lucid-tdl/parser/lexer_test.rb
+- test/lucid-tdl/parser/parser_test.rb
+- test/test_helper.rb