lucid 0.0.9 → 0.1.0

data/HISTORY.md

@@ -2,6 +2,14 @@ Change Log and History
 ======================
 
 
+Version 0.1.0 / 2013-06-02
+--------------------------
+
+The main focus of this release is some back end changes to simplify and speed up Lucid operation. Of particular note, this release has modified the Lucid Symbiont project that gets generated from the lucid-gen tool. There were errors in that project that made working with browsers problematic.
+
+Lucid is now entering its "initial development phase", notwithstanding the fact that Lucid has already been in initial development. At this point Lucid has proven stable enough to write a series of blog articles on describing how to use it. That, for the time being, is serving as the "public API" or reference implementation. Upcoming releases will more often than not be focusing on feature inclusion as opposed to small updates and internal fixes.
+
+
 Version 0.0.9 / 2013-05-22
 --------------------------
 

data/README.md

@@ -36,6 +36,8 @@ In order to to check what options are available to you from the command line, do
 
     $ lucid --help
 
+You should also check out some of my [blog posts related to Lucid](http://testerstories.com/?cat=24). They will take you through workflows of using the tool.
+
 
 Contributing
 ------------

data/lib/lucid/ast.rb

@@ -5,6 +5,7 @@ require 'lucid/ast/background'
 require 'lucid/ast/scenario'
 require 'lucid/ast/scenario_outline'
 require 'lucid/ast/step_invocation'
+require 'lucid/ast/step_invocations'
 require 'lucid/ast/step_collection'
 require 'lucid/ast/step'
 require 'lucid/ast/step_result'

data/lib/lucid/ast/background.rb

@@ -26,7 +26,7 @@ module Lucid
         @step_invocations ||= steps.step_invocations(true)
       end
 
-      def step_collection(scenario_step_invocations)
+      def create_step_invocations(scenario_step_invocations)
         if(@first_collection_created)
           steps.step_invocations(true).dup(scenario_step_invocations)
         else
@@ -36,7 +36,7 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
+        return if @already_visited
         visitor.visit_background(self) do
           comment.accept(visitor)
           visitor.visit_background_name(@keyword, name, file_colon_line, source_indent(first_line_length))
@@ -48,6 +48,7 @@ module Lucid
             visitor.runtime.after(hook_context) if @failed || feature_elements.empty?
           end
         end
+        @already_visited = true
       end
 
       def with_visitor(scenario, visitor)

data/lib/lucid/ast/comment.rb

@@ -10,7 +10,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         return if empty?
 
         visitor.visit_comment(self) do

data/lib/lucid/ast/doc_string.rb

@@ -19,7 +19,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         visitor.visit_doc_string(self)
       end
 

data/lib/lucid/ast/empty_background.rb

@@ -14,8 +14,8 @@ module Lucid
         []
       end
 
-      def step_collection(step_invocations)
-        StepCollection.new(step_invocations)
+      def create_step_invocations(step_invocations)
+        StepInvocations.new(step_invocations)
       end
 
       def step_invocations

data/lib/lucid/ast/examples.rb

@@ -20,8 +20,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
-
         visitor.visit_examples(self) do
           comment.accept(visitor)
           visitor.visit_examples_name(keyword, name)

data/lib/lucid/ast/feature.rb

@@ -30,12 +30,10 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         visitor.visit_feature(self) do
           comment.accept(visitor)
           tags.accept(visitor)
           visitor.visit_feature_name(@keyword, indented_name)
-          background.accept(visitor)
           @feature_elements.each do |feature_element|
             feature_element.accept(visitor)
           end

data/lib/lucid/ast/outline_table.rb

@@ -5,13 +5,12 @@ module Lucid
         super(raw)
         @scenario_outline = scenario_outline
         @cells_class = ExampleRow
-        example_rows.each do |cells|
-          cells.create_step_invocations!(scenario_outline)
+        example_rows.each do |example_row|
+          example_row.create_step_invocations!(scenario_outline)
         end
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         visitor.visit_outline_table(self) do
           cells_rows.each do |row|
             row.accept(visitor)
@@ -57,7 +56,7 @@ module Lucid
           end
         end
 
-        attr_reader :scenario_outline # https://rspec.lighthouseapp.com/projects/16211/tickets/342
+        attr_reader :scenario_outline
 
         def initialize(table, cells)
           super
@@ -84,8 +83,6 @@ module Lucid
         end
 
         def accept(visitor)
-          return if Lucid.wants_to_quit
-          #visitor.configuration.expand? ? accept_expand(visitor) : accept_plain(visitor)
           if visitor.configuration.expand?
             accept_expand(visitor)
           else

data/lib/lucid/ast/scenario.rb

@@ -13,7 +13,7 @@ module Lucid
 
       attr_reader   :feature_tags
       attr_accessor :feature
-      attr_reader   :comment, :tags, :keyword
+      attr_reader   :comment, :tags, :keyword, :background
 
       def initialize(language, location, background, comment, tags, feature_tags, keyword, title, description, raw_steps)
         @language, @location, @background, @comment, @tags, @feature_tags, @keyword, @title, @description, @raw_steps = language, location, background, comment, tags, feature_tags, keyword, title, description, raw_steps
@@ -22,34 +22,40 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
-
+        background.accept(visitor)
         visitor.visit_feature_element(self) do
           comment.accept(visitor)
           tags.accept(visitor)
           visitor.visit_scenario_name(keyword, name, file_colon_line, source_indent(first_line_length))
 
-          skip_invoke! if @background.failed?
+          skip_invoke! if background.failed?
           with_visitor(visitor) do
-            visitor.execute(self, skip_hooks?)
+            execute(visitor.runtime, visitor)
           end
 
           @executed = true
         end
       end
 
+      def execute(runtime, visitor)
+        runtime.with_hooks(self, skip_hooks?) do
+          step_invocations.accept(visitor)
+        end
+      end
+
       def to_units(background)
-        [Unit.new(background.step_invocations + step_invocations)]
+        [Unit.new(step_invocations)]
       end
 
       # Returns true if one or more steps failed.
       def failed?
-        steps.failed? || !!@exception
+        step_invocations.failed? || !!@exception
       end
 
       def fail!(exception)
         @exception = exception
         @current_visitor.visit_exception(@exception, :failed)
+        skip_invoke!
       end
 
       # Returns true if all steps passed.
@@ -59,13 +65,13 @@ module Lucid
 
       # Returns the first exception (if any).
       def exception
-        @exception || steps.exception
+        @exception || step_invocations.exception
       end
 
       # Returns the status.
       def status
         return :failed if @exception
-        steps.status
+        step_invocations.status
       end
 
       def to_sexp
@@ -74,7 +80,7 @@ module Lucid
         sexp += [comment] if comment
         tags = @tags.to_sexp
         sexp += tags if tags.any?
-        sexp += steps.to_sexp if steps.any?
+        sexp += step_invocations.to_sexp if step_invocations.any?
         sexp
       end
 
@@ -85,17 +91,21 @@ module Lucid
       end
 
       def skip_invoke!
-        steps.skip_invoke!
+        step_invocations.skip_invoke!
       end
 
-      def steps
-        @steps ||= @background.step_collection(step_invocations)
+      def step_invocations
+        @step_invocation ||= @background.create_step_invocations(my_step_invocations)
       end
 
       private
 
-      def step_invocations
-        @raw_steps.map{|step| step.step_invocation}
+      def steps
+        StepCollection.new(@raw_steps)
+      end
+
+      def my_step_invocations
+        @raw_steps.map { |step| step.step_invocation }
       end
 
       def skip_hooks?

data/lib/lucid/ast/scenario_outline.rb

@@ -11,11 +11,10 @@ module Lucid
 
       attr_accessor :feature
       attr_reader :feature_tags
-      attr_reader :comment, :tags, :keyword
+      attr_reader :comment, :tags, :keyword, :background
 
       module ExamplesArray #:nodoc:
         def accept(visitor)
-          return if Lucid.wants_to_quit
           return if self.empty?
 
           visitor.visit_examples_array(self) do
@@ -34,7 +33,7 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
+        background.accept(visitor)
         raise_missing_examples_error unless @example_sections
 
         visitor.visit_feature_element(self) do
@@ -70,7 +69,7 @@ module Lucid
 
       def step_invocations(cells)
         step_invocations = steps.step_invocations_from_cells(cells)
-        @background.step_collection(step_invocations)
+        @background.create_step_invocations(step_invocations)
       end
 
       def each_example_row(&proc)

data/lib/lucid/ast/specs.rb

@@ -26,8 +26,6 @@ module Lucid
       # are initially the same concept. When the spec is visited, the high
       # level construct (feature, ability) is determined.
       def accept(visitor)
-        return if Lucid.wants_to_quit
-
         visitor.visit_features(self) do
           start = Time.now
 

data/lib/lucid/ast/step.rb

@@ -47,7 +47,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         # The only time a Step is visited is when it is in a ScenarioOutline.
         # Otherwise it's always StepInvocation that gets visited instead.
         visitor.visit_step(self) do

data/lib/lucid/ast/step_collection.rb

@@ -9,59 +9,30 @@ module Lucid
         @steps.each{|step| step.step_collection = self}
       end
 
-      def inspect
-        @steps.map { |s| [s.class, s.object_id] }.join(', ')
-      end
-
       def accept(visitor)
-        return if Lucid.wants_to_quit
-
         visitor.visit_steps(self) do
           @steps.each do |step|
-            #visitor.visit_step(step)
             step.accept(visitor)
           end
         end
       end
 
       def step_invocations(background = false)
-        StepCollection.new(@steps.map{ |step|
+        StepInvocations.new(@steps.map{ |step|
           i = step.step_invocation
           i.background = background
           i
         })
       end
 
-      def skip_invoke!
-        @steps.each{|step_invocation| step_invocation.skip_invoke!}
-      end
-
       def step_invocations_from_cells(cells)
         @steps.map{|step| step.step_invocation_from_cells(cells)}
       end
 
-      def +(step_invocations)
-        dup(step_invocations)
-      end
-
-      # Duplicates this instance and adds +step_invocations+ to the end
-      def dup(step_invocations = [])
-        StepCollection.new(@steps + step_invocations)
-      end
-
       def each(&proc)
         @steps.each(&proc)
       end
 
-      def previous_step(step)
-        i = @steps.index(step) || -1
-        @steps[i-1]
-      end
-
-      def empty?
-        @steps.empty?
-      end
-
       def max_line_length(feature_element)
         lengths = (@steps + [feature_element]).map{|e| e.text_length}
         lengths.max

data/lib/lucid/ast/step_invocation.rb

@@ -32,8 +32,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
-
         visitor.visit_step(self) do
           invoke(visitor.runtime, visitor.configuration)
           step_result.accept(visitor)

data/lib/lucid/ast/step_invocations.rb

@@ -0,0 +1,73 @@
+module Lucid
+  module AST
+    class StepInvocations
+      include Enumerable
+
+      def initialize(steps)
+        @steps = steps
+        @steps.each do |step|
+          step.step_collection = self
+        end
+      end
+
+      def accept(visitor)
+        visitor.visit_steps(self) do
+          @steps.each do |step|
+            step.accept(visitor)
+          end
+        end
+      end
+
+      def each(&proc)
+        @steps.each(&proc)
+      end
+
+      def max_line_length(feature_element)
+        lengths = (@steps + [feature_element]).map{|e| e.text_length}
+        lengths.max
+      end
+
+      def skip_invoke!
+        @steps.each{ |step_invocation| step_invocation.skip_invoke! }
+      end
+
+      def +(step_invocations)
+        dup(step_invocations)
+      end
+
+      # Duplicates this instance and adds +step_invocations+ to the end
+      def dup(step_invocations = [])
+        StepInvocations.new(@steps + step_invocations)
+      end
+
+      def exception
+        @exception ||= ((failed = @steps.detect {|step| step.exception}) && failed.exception)
+      end
+
+      def status
+        @steps.each do |step_invocation|
+          return step_invocation.status if step_invocation.status != :passed
+        end
+        :passed
+      end
+
+      def failed?
+        status == :failed
+      end
+
+      def previous_step(step)
+        i = @steps.index(step) || -1
+        @steps[i-1]
+      end
+
+      def length
+        @steps.length
+      end
+
+      def to_sexp
+        @steps.map{|step| step.to_sexp}
+      end
+
+    end
+  end
+end

data/lib/lucid/ast/table.rb

@@ -177,7 +177,6 @@ module Lucid
       end
 
       def accept(visitor) #:nodoc:
-        return if Lucid.wants_to_quit
         cells_rows.each do |row|
           row.accept(visitor)
         end
@@ -630,7 +629,6 @@ module Lucid
         end
 
         def accept(visitor)
-          return if Lucid.wants_to_quit
           visitor.visit_table_row(self) do
             each do |cell|
               cell.accept(visitor)
@@ -688,8 +686,6 @@ module Lucid
         end
 
         def accept(visitor)
-          return if Lucid.wants_to_quit
-
           visitor.visit_table_cell(self) do
             visitor.visit_table_cell_value(value, status)
           end

data/lib/lucid/ast/tags.rb

@@ -10,7 +10,6 @@ module Lucid
       end
 
       def accept(visitor)
-        return if Lucid.wants_to_quit
         visitor.visit_tags(self) do
           @tags.each do |tag|
             visitor.visit_tag_name(tag.name)

data/lib/lucid/ast/tdl_walker.rb

@@ -8,13 +8,6 @@ module Lucid
         @runtime, @listeners, @configuration = runtime, listeners, configuration
       end
 
-      def execute(scenario, skip_hooks)
-        runtime.with_hooks(scenario, skip_hooks) do
-          scenario.skip_invoke! if scenario.failed?
-          scenario.steps.accept(self)
-        end
-      end
-
       # This is being used to forward on messages from the AST to
       # the formatters. This is being done in lieu of the explicit
       # forwarding that was previously done.
@@ -37,6 +30,7 @@ module Lucid
       end
 
       def broadcast_message(message, *args, &block)
+        return self if Lucid.wants_to_quit
         message = message.to_s.gsub('visit_', '')
         if block_given?
           send_to_all("before_#{message}", *args)

data/lib/lucid/generators/project/browser-symbiont.rb

@@ -5,7 +5,7 @@ module Symbiont
 
     def self.start
       unless @@browser
-        target = ENV['BROWSER']
+        target = ENV['BROWSER'] || 'firefox'
         @@browser = watir_browser(target)
       end
       @@browser
@@ -13,6 +13,7 @@ module Symbiont
 
     def self.stop
       @@browser.quit if @@browser
+      @@browser = false
     end
 
   private

data/lib/lucid/generators/project/lucid-symbiont.yml

@@ -2,5 +2,5 @@
 <% std_opts = "-r common -r pages -r steps" %>
 <% rpt_opts = "--format html --out output/specs-report.html" %>
 
-default: <%= std_opts %>
-report: <%= std_opts %> <%= rpt_opts %>
+default: <%= browser %> <%= std_opts %>
+report: <%= browser %> <%= std_opts %> <%= rpt_opts %>

data/lib/lucid/platform.rb

@@ -2,7 +2,7 @@ require 'rbconfig'
 
 module Lucid
   unless defined?(Lucid::VERSION)
-    VERSION       = '0.0.9'
+    VERSION       = '0.1.0'
     BINARY        = File.expand_path(File.dirname(__FILE__) + '/../../bin/lucid')
     LIBDIR        = File.expand_path(File.dirname(__FILE__) + '/../../lib')
     JRUBY         = defined?(JRUBY_VERSION)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lucid
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-22 00:00:00.000000000 Z
+date: 2013-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -171,6 +171,7 @@ files:
 - lib/lucid/ast/step.rb
 - lib/lucid/ast/step_collection.rb
 - lib/lucid/ast/step_invocation.rb
+- lib/lucid/ast/step_invocations.rb
 - lib/lucid/ast/step_result.rb
 - lib/lucid/ast/table.rb
 - lib/lucid/ast/tags.rb
@@ -260,7 +261,7 @@ homepage: https://github.com/jnyman/lucid
 licenses:
 - MIT
 post_install_message: ! "\n(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)
-  (::)\n\n  Thanks for installing Lucid 0.0.9.\n\n(::) (::) (::) (::) (::) (::) (::)
+  (::)\n\n  Thanks for installing Lucid 0.1.0.\n\n(::) (::) (::) (::) (::) (::) (::)
   (::) (::) (::) (::) (::)\n  "
 rdoc_options:
 - --charset=UTF-8
@@ -283,6 +284,6 @@ rubyforge_project:
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: lucid-0.0.9
+summary: lucid-0.1.0
 test_files: []
 has_rdoc: